API do Banco do Brasil: o que dá para fazer e como usar com agentes de IA
O Banco do Brasil oferece APIs para empresas correntistas, com Pix, cobrança por boleto, extratos e pagamentos, entre outras. São usadas por áreas financeiras, ERPs e fintechs que automatizam recebimentos e conciliação. O acesso exige cadastro no portal de desenvolvedores, aplicação aprovada e vínculo com a conta e os convênios da empresa.
Os grandes recursos da API, em português claro.
Cobranças com QR Code, consulta de Pix recebidos e devoluções.
Registro, consulta, alteração e baixa de boletos do convênio de cobrança.
Consulta de lançamentos para conciliação.
Envio de lotes de pagamentos e transferências, conforme habilitação.
Avisos de recebimento para baixa automática.
Como se acessa a API do Banco do Brasil.
- Com credencial da sua empresaOAuth 2.0 com credenciais da aplicação cadastrada no portal do BB e chave de desenvolvedor; em produção, algumas APIs exigem certificado digital e convênio ativo.
- Documentação oficialdevelopers.bb.com.br
- Cada API precisa ser habilitada e vinculada a convênio; confirme o escopo com o gerente.
- Proteja o certificado e as credenciais: são equivalentes a acesso à conta.
- Mantenha pagamentos sob aprovação humana e teto de valor.
- api banco do brasil
- api bb pix
- api banco do brasil boleto
- api bb cobrança
- developers bb
- api banco do brasil extrato
- integração api banco do brasil
O que um agente do iTeam faz com a API do Banco do Brasil.
O agente recebe o aviso de Pix ou consulta boletos liquidados e dá baixa no contas a receber do ERP, separando o que não bateu.
O agente lê o extrato, casa os lançamentos com títulos e despesas e entrega ao financeiro só as exceções.
No WhatsApp, o cliente pede o boleto e o agente consulta o título no convênio e envia o código atualizado.
O agente monta o lote de fornecedores do dia a partir do ERP; a liberação fica com quem tem alçada no banco.
Da credencial ao agente trabalhando, com aprovação.
Cadastre a aplicação no portal do BB
Crie a aplicação, teste no ambiente de homologação e solicite a produção vinculada à conta e aos convênios da empresa.
Guarde credenciais e certificado no cofre do iTeam
Somente o agente financeiro acessa, com permissões separadas para consulta e para operações.
Operações com dupla aprovação
Consulta e conciliação rodam direto; pagamentos e devoluções exigem aprovação humana e seguem as alçadas do banco.
Dúvidas sobre a API do Banco do Brasil.
A API do Banco do Brasil é gratuita?
Depende do produto e do relacionamento: algumas APIs não têm custo de chamada, mas tarifas de cobrança, Pix e pagamentos seguem o contrato com o banco.
Preciso programar para usar a API do Banco do Brasil com o iTeam?
Não necessariamente. A ferramenta HTTP do iTeam lê a documentação e o time de implantação configura junto com o seu financeiro.
Existe homologação?
Sim, o portal oferece ambiente de testes antes da liberação em produção.
Que automações financeiras um agente de IA faz com as APIs do Banco do Brasil?
O portal do BB reúne APIs de Pix, cobrança por boleto, extrato e pagamentos em lote, e o agente atua nelas. Ele registra boletos, confere recebimentos, concilia o extrato com o ERP e prepara pagamentos para aprovação. A liberação do pagamento é de uma pessoa. No iTeam, a conciliação vira lista de divergências para o financeiro.
O portal de desenvolvedores do Banco do Brasil tem sandbox?
Sim: a aplicação é cadastrada primeiro no ambiente de sandbox do portal, que fornece as credenciais de homologação. Você testa cobrança e Pix ali antes de pedir a produção. Fóruns de integradores relatam instabilidade pontual na simulação de pagamento de Pix em homologação, então confira o estado do ambiente na documentação oficial.
Como é a autenticação das APIs do BB: OAuth, chave e certificado?
Usa OAuth 2.0 com client id e client secret da aplicação, mais uma chave de aplicação de desenvolvedor enviada nas chamadas. Para a API Pix v2, o certificado digital com conexão segura também é exigido em produção. Cada API tem escopos próprios. Guarde credenciais e certificado em cofre, pois equivalem a acesso à conta.
Posso usar as APIs do BB sem ser correntista com convênio?
Não: o acesso exige vínculo com a conta e, para cobrança, com o convênio da empresa. A aplicação precisa ser aprovada e cada API habilitada. Confirme o escopo com o gerente de relacionamento antes de planejar o fluxo. Sem convênio de cobrança ativo, o registro de boletos não funciona, mesmo com a aplicação cadastrada.
O boleto híbrido com Pix pelo BB exige algum pré-requisito?
Sim: segundo integradores, o emitente precisa ter chave Pix cadastrada no BB, e o indicador de Pix deve ser ativado na emissão. Confira na documentação do portal os campos do boleto híbrido e o comportamento quando falta a chave. O agente valida esses requisitos antes de registrar, para não gerar boleto sem a parte Pix.
Como o agente concilia recebimentos do BB com o ERP?
Lê o extrato e os avisos de Pix pelos webhooks, cruza valor, data e identificador com os títulos abertos e dá baixa quando batem. O que não bate vai para uma lista com o motivo provável. A conciliação diária deixa de depender de planilha. O ERP precisa ter API para a baixa; o iTeam integra os que têm.
Pagamentos em lote pelo BB podem ser aprovados pelo agente?
Não sozinho: pagamento é saída de dinheiro e deve ficar sob aprovação humana, com teto de valor. O agente monta o lote a partir das contas aprovadas, confere favorecido e valor e apresenta para liberação. Registre quem aprovou e o identificador do lote. Isso evita pagamento duplicado e fraude por e-mail falso.
Que cuidados o agente precisa ter com o certificado digital do BB?
O certificado é equivalente à senha da conta: armazene em cofre, restrinja quem pode gerenciá-lo e renove antes do vencimento, porque o certificado vencido derruba as chamadas de Pix. O agente nunca deve vê-lo em texto. Tenha um responsável pelo calendário de renovação e um alerta antes da data de expiração.
