Início / PORTAL DA ADMINISTRAÇÃO / Integração bancária

Integração Banco Itaú

Manual de integração de cobranças pela API Itaú

1 – Como proceder para iniciar o processo de integração


  • Entrar em contato com o gerente da conta e solicitar a Ativação do convênio de cobrança por API.

  • Caso o gerente tenha alguma dúvida, existe material referente ao assunto junto ao site do Itaú. https://devportal.itau.com.br/

  • Solicitar para habilitar no “Ambiente de produção”, sendo: API Bolecode, API de Emissão, Instrução e consulta de boletos. 

  • Caso o gerente solicitar os dados do desenvolvedor, informe os dados da administradora e responsável pelo processo para centralizar as informações. (Dados da empresa e um contato com e-mail e telefone).

  • O acompanhamento do processo será feito por e-mail e assim que avançar deverá ser acionado o suporte Winker Pro para auxiliar no processo de homologação.

  • Após ativado o ambiente de produção da API, gerar “Chave pública” no sistema e enviar para o contato do banco.

  • O banco envia o Token temporário (3 tentativa/válido por 7 dias) 

  • Caso tenha passado do prazo e precise refazer esse processo, gere novas chaves públicas e envie informando que necessita do Token temporário.


Informações complementares


  • Durante o registro do bolecode o Itaú realiza a validação do CEP do sacado, recomendamos verificar se o cadastro do condomínio está correto.

  • Bolecode é o nome da solução do banco Itaú para gerar boletos com o QRCode que possibilita o pagamento por PIX.

  • Carteira 109 contratada.

  • Chave pix configurada.


2 – Como gerar a chave públicas

Acesse o sistema em CONTAS FINANCEIRAS – Opções – Alterar informações - cadastro da conta.

Em APIS DE INTEGRAÇÃO:

  • REGISTRO DE BOLETO e/ou CONSULTA/BAIXA BOLETO

O banco Itaú possui duas APIs diferentes, uma para registro e liquidação de boletos, e outra para consulta e baixa de boletos, por esse motivo é necessário configurar as duas para obter essas funcionalidades integradas.


Após realizar o download da chave pública envie para o contato no banco Itaú. Aguarde o retorno do CLIENTE_ID e o TOKEN.


3 – Ativando a API

Após receber o Client_id e o Token, acesse em APIs de integração a módulo correspondente para configurar as credenciais.

Clique no botão “Já possui Client_id e Token temporário”.


  • Informe o CLIENT_ID e o TOKEN nos campos correspondentes e ATIVAR API.



  • Realizado o processo de inclusão do das credenciais o sistema processará o certificado digital e apresentará na tela.


Ao completar o processo de integração, é importante fazer um boleto avulso e registrar para validar o funcionamento.

Acesse em Títulos a receber cadastre um título avulso em nome de uma pessoa diferente do titular da conta, com valor baixo para efetuar o pagamento e validar a liquidação autônoma.