Banco do Brasil
Banco Público

Integração com Banco do Brasil

Conecte sua empresa ao maior banco público do Brasil. Emita boletos registrados, gerencie cobranças PIX e receba pagamentos diretamente na sua conta através do portal Developers BB com total segurança.

Vantagens da Integração Banco do Brasil

Portal Developers BB

Acesse credenciais através do portal oficial com processo 100% online e documentado.

PIX Instantâneo

Gere QR Codes PIX dinâmicos e receba pagamentos instantaneamente na sua conta BB.

Boletos Registrados

Emita boletos com registro automático, código de barras e linha digitável validados.

Segurança Bancária

APIs com autenticação OAuth 2.0 e certificado digital para máxima segurança.

Ambiente Sandbox

Teste sua integração em ambiente de homologação antes de ir para produção.

Direto na sua Conta

Receba pagamentos diretamente na sua conta PJ Banco do Brasil, sem intermediários.

Requisitos para Integração

1. Conta PJ no Banco do Brasil

Você precisa ter uma conta jurídica (PJ) ativa no Banco do Brasil com acesso ao internet banking empresarial.

2. Cadastro no Portal Developers BB

Acesse o Portal Developers BB e crie uma conta de desenvolvedor vinculada ao CNPJ da sua empresa.

O portal oferece documentação completa, ambiente de testes (sandbox) e gerenciamento de credenciais.

3. Credenciais de API

Você precisará das seguintes credenciais geradas no portal:

  • Client ID (identificador da aplicação)
  • Client Secret (chave secreta)
  • Developer Application Key (App Key)

4. Dados Bancários

Informações da sua conta corrente:

  • Agência (sem dígito verificador)
  • Número da conta corrente (sem dígito verificador)
  • Convênio de cobrança (para boletos)

Como Obter as Credenciais no Portal Developers BB

1

Acesse o Portal Developers

Entre no Portal Developers BB e faça login ou crie uma nova conta usando o CNPJ da sua empresa.

Você precisará ter acesso à conta bancária empresarial para validar o cadastro.

2

Crie uma Nova Aplicação

No painel, clique em "Criar Aplicação" e preencha as informações:

  • Nome da aplicação (ex: "Intopays - Sistema de Pagamentos")
  • Descrição do uso da aplicação
  • Selecione a aba "APIs com contratação online"
3

Selecione os Escopos (Scopes)

Escolha as APIs que você deseja utilizar na sua aplicação:

  • COBRANÇAS - Para emissão de boletos registrados
  • PIX - Para geração de QR Codes PIX e cobranças instantâneas

Você pode ativar ambos os escopos na mesma aplicação.

4

Complete a Contratação

Submeta a aplicação para produção preenchendo os dados necessários:

  • CNPJ da empresa
  • Dados da conta corrente
  • Número do convênio de cobrança (obtenha com seu gerente se não tiver)
  • Termos de uso e políticas

O processo de aprovação pode levar de 2 a 5 dias úteis.

5

Obtenha as Credenciais

Após aprovação, acesse a seção "Credenciais" na aba Produção para visualizar:

  • Client ID - Identificador público da aplicação
  • Client Secret - Chave secreta (guarde com segurança)
  • Developer Application Key (App Key) - Chave de desenvolvedor

Copie e armazene essas credenciais em local seguro. Elas serão usadas na configuração do Intopays.

Dica: Use o Ambiente Sandbox

O Portal Developers BB oferece um ambiente de testes (sandbox) onde você pode experimentar as APIs antes de contratar em produção. Use-o para validar sua integração sem custos ou riscos.

Configurando no Intopays

Após obter as credenciais do Portal Developers BB, configure a integração no dashboard do Intopays:

1

Acesse a Área de Credenciais

No dashboard do Intopays, navegue até Integração → Credenciais e clique em "Adicionar Nova Credencial".

2

Selecione Banco do Brasil

Escolha "Banco do Brasil" na lista de bancos e preencha os dados obtidos no Portal Developers:

  • Client ID
  • Client Secret
  • Developer Application Key (App Key)
  • Agência e Conta Corrente
  • Número do Convênio (para boletos)
3

Teste a Conexão

Clique em "Testar Conexão" para verificar se as credenciais estão corretas e a API está respondendo corretamente.

Conexão bem-sucedida! Sua integração está pronta para uso.

Pronto para Usar!

Sua integração com Banco do Brasil está configurada! Agora você pode emitir boletos, gerar cobranças PIX e gerenciar tudo através do dashboard do Intopays ou via API REST.

Importante: Segurança das Credenciais

Suas credenciais (Client ID, Client Secret e App Key) são dados sensíveis. Nunca compartilhe essas informações ou as exponha em código público. O Intopays armazena todas as credenciais com criptografia de alto nível e seguindo as melhores práticas de segurança bancária.

Próximos Passos

Emitir seu Primeiro Boleto

Use o dashboard ou API para emitir boletos registrados com código de barras validado.

Ir para Boletos

Gerar Cobranças PIX

Crie QR Codes PIX dinâmicos e receba pagamentos instantâneos na sua conta BB.

Ir para PIX

Explorar a Documentação

Veja exemplos de código e aprenda a usar nossa API completa com Node.js e Java.

Ver Docs

Configurar Webhooks

Receba notificações em tempo real sobre pagamentos e mudanças de status sem polling.

Configurar

Pronto para Integrar com Banco do Brasil?

Crie sua conta gratuita no Intopays e comece a configurar sua integração com o maior banco público do Brasil. Sem custos iniciais, sem complicações.