Particularidades de Configuração da API
Banco Itaú
| Atenção | ||||||||
| Para melhor visualização das imagens, clique sobre elas. | ||||||||
Para realizar as configurações relevantes ao uso da API de Cobrança pelo BankPlus, siga o guia detalhado:
1° O próprio cliente deve entrar em contato com o banco para a contratação da API.
2º Após a contratação da API, é responsabilidade da consultoria e do cliente junto ao banco de realizar a homologação, geração do certificado e configurações no contrato bancário. Para saber mais informações sobre a configuração do contrato, siga a documentação.
Existem quatro versões de API disponíveis para o banco Itaú, confira as diferenças entre cada uma delas. As versões 1 e 3 geram o boleto apenas com o código de barras, as demais versões geram o boleto com código de barras e com QrCode PIX.
| Importante | ||||||||
| Para saber detalhes do procedimento para as versões que também geram QrCode PIX, acesse: Registar Boletos com QR Code PIX no Itaú via API | ||||||||
| Versão da API - Itaú | Boleto | BolePIX | PIX Puro | Consulta | Alteração Vencimento | Pedido de Cancelamento | WebHook |
| V1.0 - Boleto Online - JSON* | 🗸 | 🗸 | 🗸 | ||||
| V2.0 - Boleto Online PIX - JSON | 🗸 | 🗸 | 🗸** | 🗸 | |||
| V2.0 - Boleto Online - JSON | 🗸 | 🗸 | 🗸 | ||||
| V2.0 - BoleCode - JSON | 🗸 | 🗸 | 🗸 | 🗸 | 🗸 | 🗸 | 🗸** |
| V1.0 - Boleto com Pix | 🗸 | 🗸 | 🗸 | 🗸 | 🗸 |
* - Essa versão foi descontinuada pelo Itaú
** - A consulta via API só está disponível para PIX Puro.
Em Tipo de Ambiente selecione o cenário onde as operações serão realizadas, em produção são operações reais.
Após selecionar a versão da API, aparecerão os demais campos para configuração:
| Importante | ||||||||
| As informações Cliente ID e Chave Secreta serão fornecidas pelo próprio banco após a finalização da contratação desse serviço, ressaltando que essas informações são únicas para cada cliente. | ||||||||
Em Certificado Digital selecione um certificado, podendo ser o próprio certificado da empresa.
As demais informações são preenchidas automaticamente pelo BankPlus, após finalizar as definições clique em Atualizar:

As demais informações são preenchidas automaticamente pelo BankPlus, após finalizar as definições clique em Atualizar:
| Importante | ||||||||
| A consulta dos títulos via API para o Itaú só funciona quando for PIX puro. | ||||||||
Para o processo de homologação é necessário realizar a validação do JSON de envio. Para isso, acesse BankPlus → Cobrança → Títulos Bancários. Após realizar o Registro Online via API, selecione o título e clique em Histórico:
Arraste a barra de rolagem para encontrar a coluna que grava a informação referente ao envio do JSON de comunicação.