🧪 Nova Experiência: Você está testando nossa nova documentação. Dê sua opinião
erp4me

Baixa automática de boletos via API do Banco do Brasil: por Webhook


Introdução

A integração por Webhook garante que as baixas dos boletos pagos pelos seus clientes sejam registradas instantaneamente no Bimer. 

O Webhook funciona como um notificador inteligente do Banco do Brasil para o seu sistema de gestão. Enquanto no modelo tradicional de baixa automática do Bimer precisa consultar o banco repetidamente para verificar novos pagamentos, o Webhook inverte esse fluxo: o próprio banco envia um alerta automático para o sistema assim que o dinheiro entra na conta. A partir desse aviso, o sistema liquida o título correspondente de forma totalmente autônoma.


Passo a passo de Configuração

Pré-requisito: Credenciais de acesso ao portal BB.

  1. Acesse o Portal Developers BB através do seu navegador e realize o login com os dados da sua conta empresarial.

  2. Selecionar a aplicação correspondente: No painel principal, navegue até a opção de menu Aplicações e selecione a sua aplicação cadastrada correspondente ao serviço de Cobrança (ou Pix/Pagamentos, conforme o contrato contratado).

Clique aqui para conferir
image-20260807-134900.png


  1. Preencher os dados de integração: Localize e clique na aba Webhook. Em seguida, preencha os campos obrigatórios conforme as orientações a seguir:

Clique aqui para conferir
image-20260807-134938.png


a. Identificador: Digite o número do seu convênio de cobrança (ou chave Pix/contrato).

b. URL de callback: Cole exatamente o seguinte endereço eletrônico: (https://boleto-api-meios-pagamento.alterdatasoftware.com.br/notificacao/boleto/BANCOBRASIL](https://boleto-api-meios-pagamento.alterdatasoftware.com.br/notificacao/boleto/BANCOBRASIL)

c. E-mail de contato: Informe um e-mail válido da sua empresa para o recebimento de notificações técnicas do serviço.

  1. Valide a segurança do tráfego: Verifique se o indicador de certificado de segurança está ativo na página para garantir o envio criptografado e seguro dos seus dados financeiros.

Clique aqui para conferir
image-20260807-135948.png


  1. Salvar a configuração: Clique no botão Salvar localizado ao final da página para confirmar e ativar o envio das notificações.

Pronto! A partir desse momento, todas as baixas e confirmações de pagamento, através do gerente eletrônico, serão atualizadas em tempo real