LOOMING | Iminente
  1. Bancos Integrados
LOOMING | Iminente
  • Sobre a API
  • Conhecendo a plataforma
  • Dados fictícios para testes
  • Autenticação
  • Webhook
  • Beneficiarios
    • Incluir beneficiário
      POST
    • Altera um beneficiário
      PATCH
    • Altera status beneficiário
      GET
    • Apagar beneficiário
      DELETE
    • Recupera lista de beneficiários
      GET
  • Contas
    • Altera status conta
      GET
  • API Boleto
    • Cobrança
      • Registro de boleto
      • Baixa de boleto
      • Recupera boleto
      • Recupera uma lista de boletos por lote
      • Sincronizar boletos pagos
      • Retorna chamada de webhook
    • Bancos Integrados
      • 001 - Banco do Brasil
      • 033 - Banco Santander
      • 041 - Banco Banrisul
      • 070 - Banco BRB
      • 077 - Banco Inter
      • 136 - Banco Unicred
      • 237 - Banco Bradesco
      • 237 - Banco Bradesco Copy
      • 341 - Banco Itaú
      • 336 - C6 Bank
      • 403 - Banco Cora
      • 748 - Banco Sicredi
      • 756 - Banco Sicoob
    • Limitações
      • Instruções Boletos
      • Descontos
      • Expurgo
      • Inativar conta
  • API Pix
    • Cobrança
      • Registro Cob
      • Registro CobV
    • Bancos Integrados
      • 756 - Banco Sicoob
  • API Cartão
    • Status transacional
    • Gateways Integrados
      • Cielo
    • Cobrança
      • Retornos Webhook
      • Criar pagamento com cartão
  1. Bancos Integrados

001 - Banco do Brasil

Guia Rápido: Integrando seu App com o BB Developers#

Este guia simplifica o processo de configuração do seu aplicativo no Portal BB for Developers, desde o cadastro até a operação em produção.

1. Cadastro no Portal BB for Developers#

1.
Acesse a página inicial do Portal BB for Developers.
2.
Clique em "Cadastre-se".
3.
Preencha: CPF, nome da mãe, data de nascimento, e-mail e celular válidos.
4.
Um código de confirmação será enviado para o celular cadastrado no Banco.
5.
Insira o código e crie uma senha.
6.
Se recebeu um convite por e-mail, insira a chave/código após o primeiro acesso.

2. Criação da Aplicação#

Após o cadastro, você precisará criar sua aplicação:
1.
Clique em "+ Nova Aplicação".
2.
Preencha:
Nome da aplicação: "Looming GW"
Descrição: "Integração de boletos por API"
URL de imagem para ícone: Não é necessário.
URI de call-back: Não é necessário.
3.
Clique no contêiner do app para acessar a área do desenvolvedor.
4.
As credenciais de teste são geradas automaticamente e estão em "Credenciais" no menu lateral.
Para dúvidas sobre credenciais ou fluxos de autorização, consulte a seção "Segurança" em "Documentos".

3. Gerando Access Token (Credenciais)#

Para fazer requisições às APIs, você precisará gerar um Access Token.

4. Enviando sua Aplicação para Produção#

Para usar as APIs do BB em seu negócio, sua aplicação deve ir para produção:
1.
Verifique se o status da sua aplicação está "Em desenvolvimento".
2.
No menu lateral, selecione "Produção".
3.
Informe o CNPJ da empresa e revise os dados da aplicação.
4.
Contratação da API de Cobrança:
Com convênio ativo: A contratação é automática.
Sem convênio: O BB entrará em contato para finalizar a contratação. O status da sua aplicação será "Aguardando aprovação" até a aprovação.

5. Fazendo Requisições no Ambiente de Produção#

1.
É essencial ter um convênio de prestação de serviço ativo. Se já tem, informe os dados na requisição. Se não, aguarde o contato do BB.
2.
Altere os endpoints das APIs para produção.
3.
Lembre-se que em produção, todos os dados são reais. Sugerimos realizar testes com valores simbólicos (ex: boleto de R$ 0,01).
4.
Ao final, envie ao seu integrador as seguintes chaves: Client ID, Client Secret e Application Key.
Para mais dúvidas, acesse o portal de apoio do BB: https://apoio.developers.bb.com.br/referency/post/5f4f8129b71fb5001268c99d
INFO
Gerenciamento de Webhook no BB
Para otimizar o fluxo de integração do seu aplicativo com o Banco do Brasil (BB) e garantir a correta configuração do Webhook, o processo se desdobra em algumas etapas cruciais:
1. Conclusão do Cadastro e Integração Inicial:
Após o cadastro bem-sucedido do seu aplicativo no BB e o envio das informações necessárias ao seu integrador, é fundamental aguardar a finalização da primeira fase da integração. Esta etapa valida a comunicação inicial entre seu sistema e o ambiente do BB.
2. Solicitação e Cadastro da URL do Webhook:
Com a integração inicial concluída, o próximo passo é solicitar a URL específica do Webhook ao seu integrador. Esta URL será o ponto de comunicação para notificações e eventos futuros. Uma vez que você tenha a URL em mãos, ela deverá ser cuidadosamente cadastrada no aplicativo do BB, garantindo que o banco possa enviar informações relevantes diretamente para o seu sistema.
Precisa de ajuda para entender qual URL de Webhook seu integrador deve fornecer ou como cadastrá-la no aplicativo do BB?
Cadastrando o Webhook do Looming no BB Developers
Para configurar seu Webhook do Looming no portal BB Developers, siga estes passos simples:
1. Obtendo o Link do Webhook no App Looming
Primeiro, acesse a conta já configurada no seu aplicativo Looming. Dentro dela, localize o link do Webhook. Este link é crucial, pois é ele que será registrado no portal BB Developers. O padrão do link será semelhante a este:
https://api.looming.com.br/boleto/001/58567720-7456-4d3b-87cb-f34c0e283d67/webhook
2. Cadastrando o Webhook no Portal BB Developers
Com o link em mãos, vá até o portal BB Developers e entre no seu aplicativo. Procure pela seção de "Eventos". Dentro de "Eventos", clique em "Cadastrar novo evento" e cole a URL do Webhook que você copiou do Looming.
Após o cadastro, uma tela de confirmação, similar à imagem abaixo, será exibida.
image.png
Modified at 2025-07-25 12:26:58
Previous
Retorna chamada de webhook
Next
033 - Banco Santander
Built with