ajuda

Cobrança Banco do Brasil: o que configurar

Atualizado em 30 de agosto de 2026

O que o Banco do Brasil pede na tela Financeiro → Carteiras → + Nova, depois de escolher o provedor Banco do Brasil.

Obrigatórios

  • Developer App Key — senha (fica cifrada)
  • Client ID — texto
  • Client Secret — senha (fica cifrada)
  • Certificado (.crt) — arquivo
  • Chave privada (.key) — arquivo
  • Convênio — texto
  • Carteira — texto

Opcionais

  • Variação da carteira — texto

É o que pede mais coisa. Além do trio OAuth, tem a Developer App Key — uma chave à parte, gerada no portal developers.bb.com.br ao criar a aplicação de Cobrança — e o convênio com a carteira, que vêm do seu gerente, não do portal. Sem convênio e carteira o boleto não registra.

Abaixo das credenciais vem o bloco de parametrização da cobrança (multa, juros, desconto, protesto, instruções), igual para todos os bancos de boleto registrado — está descrito no artigo Multa, juros, desconto e protesto: o bloco comum a todos os bancos.

Cada campo tem um ⓘ com a dica do que é. Senhas e certificados são gravados cifrados e nunca voltam para a tela.

Formulário de carteira com o provedor Banco do Brasil selecionado, mostrando os campos que ele pede

A ação ao vivo: escolher Banco do Brasil e ver os campos que aparecem.