Guia de Integração | Itaú Retorno

---

1. Introdução

Esta documentação descreve a integração complementar à API do Itaú: a API de Retorno, responsável por processar automaticamente os eventos de retorno de boletos registrados (originados por remessa, API v2 ou API Bolecode). Essa API recebe e normaliza os avisos de processamento (por exemplo: liquidações, baixas, estornos, alterações de vencimento e outros eventos) e os disponibiliza ao seu sistema para que sejam tratados automaticamente.

Benefícios do retorno automático

• Automação do processo— atualiza o status dos boletos no sistema sem intervenção manual, reduzindo tempo gasto em conferência e lançamentos.

• Redução de erros e retrabalho — diminui inconsistências humanas (lançamentos duplicados, pagamentos não identificados ou baixas incorretas).

• Atualização em tempo real — eventos são entregues automaticamente, permitindo respostas rápidas (ex.: liberação de serviços).

• Melhoria do fluxo de caixa — visibilidade imediata sobre recebimentos facilita planejamento financeiro e tomada de decisão.

• Conformidade e rastreabilidade — todos os eventos ficam registrados, melhorando auditoria e atendimento a requisitos regulatórios.

• Escalabilidade operacional — processa grandes volumes de retornos sem aumentar proporcionalmente a equipe.

• Melhor experiência do cliente — confirmações e tratativas automáticas aceleram reembolsos, cancelamentos e comunicação com pagadores.

2. Dados necessários para integrar ao SGP

Nesta etapa da documentação, abordaremos a integração da API bancária do Banco Itaú para retorno automático de Boleto.

As credenciais utilizadas para esta integração são as mesmas empregadas nas APIs de Boleto e Bolecode, podendo ser replicadas no novo gateway sem necessidade de reconfiguração adicional.

Para realizar essa integração, serão necessários alguns dados e arquivos, como:

• Client ID

• Token Bearer

Os dados acima correspondem às informações base enviadas pelo Itaú. A partir delas, é necessário seguir o processo indicado pelo banco para gerar as demais credenciais listadas a seguir:

• Client Secret 
• Certificado PFX 

3. Cadastro do Gateway de Retorno

Com os dados em mãos, podemos integrar o Gateway ao SGP para retorno de Boleto Itaú

Clique no botão Cadastrar e preencha da seguinte forma:

Imagem de Referência (API Retorno)

4. Informações Adicionais