Atenção ! Descontinuação do endpoint atual da API Bolecode (Bolecode Pix) do Itaú, NOVA API de Boleto Hibrido disponível para testes

[Daniel InfoCotidiano]

O Banco Itaú comunicou a descontinuação do endpoint atual da API de Boleto Híbrido. A partir de agora, os desenvolvedores devem migrar para o novo endpoint Bolecode Pix, que combina a geração de boletos com QR Codes, garantindo mais segurança e agilidade.

 

Endpoints descontinuados:

• Nome: itau-ep9-gtw-pix-recebimentos-conciliacoes-v2-ext

• Versão: 2.148.4

• Base path (produção): https://secure.api.itau/pix_recebimentos_conciliacoes/v2

• Sandbox: https://sandbox.devportal.itau.com.br/itau-ep9-gtw-pix-recebimentos-conciliacoes-v2-ext/v2

Novos endpoints (Bolecode Pix):

• Versão: 1.0.4

• Base path (produção): https://pix-pj.api.itau.com/recebimentos-pix/v1

• Sandbox: https://sandbox.devportal.itau.com.br/itau-ep9-api-recebimentos-v1-externo/v1

 Atenção: Até o momento (14/05/2026), a documentação oficial do Itaú não foi atualizada. Por exemplo, a documentação orienta enviar o valor como 12345.56, mas na prática a nova API exige o formato com 17 posições (00000000000123456 — 15 dígitos inteiros + 2 decimais).

O suporte do Itaú informou que o formato correto é 99999999999999900 e que a documentação será revisada em breve.

O que estamos disponibilizando?

Para evitar quebras na emissão de boletos, disponibilizamos uma unit de envio para o novo endpoint, compatível com Lazarus e Delphi (projeto ACBr). Você pode testar e contribuir com a validação:

ACBrBoletoW_Itau_API.pas

 

Passos para atualizar:

1. Atualize seu repositório do ACBr.

2. Salve a nova unit (anexada acima) na pasta: ..\ACBr\Fontes\ACBrBoleto\WS

3. Execute o instalador do ACBr (para Lazarus, reconstrua a IDE).

Um de nossos usuários já testou em produção com sucesso, utilizando as mesmas credenciais e parâmetros — apenas com a atualização das units.

O que muda para quem usa ACBrBoleto?

Nada. Mantivemos a compatibilidade para que sua aplicação não seja impactada.

Como a documentação oficial ainda não foi atualizada, contamos com a colaboração de desenvolvedores para testar a nova unit e validar em seus ambientes. (Sandbox  Boleto Itau, retorna erro, pois tem o ambiente para teste) , esta unit não foi enviada para o SVN! 

Em caso de problemas, abra um tópico no fórum do ACBr.

Logs de exemplo:

• Homologação:
  14/05/26 13:35:11 - URL: [POST] https://sandbox.devportal.itau.com.br/itau-ep9-api-recebimentos-v1-externo/v1/boletos-pix
  Observação: O ambiente sandbox para Boleto Híbrido/Bolecode não está disponível.

• Produção:
  14/05/26 13:39:40 - URL: [POST] https://pix-pj.api.itau.com/recebimentos-pix/v1