Como Integrar com Banco do Brasil

Para configurar a integração com o Banco do Brasil siga os passos abaixo:

1 - Criar cadastro no BB

Obs: Caso já tenha cadastro, avançar até a página 6

Necessário realizar cadastro no portal do desenvolvedor

https://acesso.bb.com.br/v2/login?appId=ipa-developers

Após digitar o CPF, o sistema irá validar se já existe cadastro.

Caso já exista, o sistema exibirá a tela abaixo para início do cadastro.

Realizar cadastro conforme passo a passo das telas a seguir.

Realiza verificação de e-mail

Clicar no botão “Concordar”.

2 - Criar nova aplicação

Antes de criar uma nova aplicação, é necessário falar com o gerente para vincular o seu cadastro neste portal à sua conta bancária.

No menu principal, clique em criar uma nova aplicação.

De um nome para aplicação e uma descrição conforme imagem abaixo

Selecione as 3 aplicações abaixo (Pix, Extratos e cobranças) e clique em seguida em criar.

3 - Cadastrar aplicação para ambiente de produção

Ao retornar ao menu principal, clique em enviar para produção.

Em seguida, o sistema exibe a tela abaixo.

Informar o cnpj da empresa e clicar em pesquisar. O sistema irá localizar o cnpj. É necessário clicar em vincular e em seguida é exibido a tela abaixo.

Clicar em confirmar para o sistema exibir a tela de aceitação dos termos 

É necessário marcar a opção “Li e concordo com os termos de uso” nos 3 documentos (Cobrança, PIX e Extratos).

Na última validação, o sistema exibe o botão assinar.

Após assinatura, é necessário realizar avaliação da configuração(quantidade de estrelas) do envio para produção.

Em seguida clicar em enviar

Em seguida, o sistema exibe a tela abaixo indicando que a aplicação está no ambiente de produção.

4 - Gerar Credenciais

No menu principal, clicar na aplicação e em seguida credenciais

Em seguida, clicar em ambiente de produção.

Clicar em gerar credenciais

Em seguida, o sistema exibe as credenciais que devem ser copiadas para o dentro do BomControle.

Copiar os 3 ids e colar no BomControle (Cadastro da conta do cliente)

A empresa deve possuir um certificado do tipo A1(Mesmo certificado para geração de emissão de nota fiscal) Normalmente um arquivo .pfx. O Certificado da empresa deve estar aparecendo conforme imagem abaixo.

Caso não tenha certificado, importar o certificado .pfx A1 da empresa e informar a senha. Em seguida, clique no ícone + para adicionar o certificado.

Com o certificado já importado no sistema, clique no ícone de download para baixar a chave pública do certificado (.crt)

Mantendo a tela do BomControle aberta no cadastro da conta, voltar ao portal do BB e clicar em avançar.

Em seguida, o sistema exibe a mensagem abaixo.

Clicar em já armazenei

5 - Gerar Certificados

No menu principal, abrir a aplicação e selecionar a opção certificado

Desça até o final da página e clique em enviar certificado.

O sistema exibirá a tela abaixo.

Clicar no botão “Importar cadeia completa” e fazer o upload do arquivo baixado do cadastro da conta do BB no BomContole.

Após esta importação, clicar em enviar.

O sistema exibirá no histórico de envios o status do certificado importado no rodapé da pagina com situação aguardando.

A situação não estará ok logo após a importação. 

Para atualizar o status, clique na descrição atualizar.

O usuário deve aguardar a situação ficar com o ícone conforme imagem abaixo.

Devemos retornar ao sistema BomControle e clicar em Conectar.

Em seguida, o sistema exibe o botão desconectar e os serviços devem estar descritos como sim.

6 - Cadastro de webhook

Clicar na aplicação.

Selecionar a opção webhook

Voltando ao BomControle, copiar o endereço de webhook gerado conforme tela abaixo

No site do BB, garantir que estamos selecionados na aba Eventos.

Clicar em cadastrar novo evento.

Na próxima tela, devemos garantir que os dois campos abaixo estejam marcados.

Em seguida, no campo URL do servidor na tela do webhook que é exibida no site do BB, devemos colar o endereço copiado do sistema BomControle.

É necessário informar também um e-mail de um responsável pelo financeiro.

Clicar em salvar para o sistema exibir a tela a seguir.

Conforme imagem acima, o sistema exibe o webhook já cadastrado com sucesso.

Neste momento o usuário poderá retornar ao BomControle e clicar em salvar no cadastro da conta bancária

Conclusão

Seguindo este guia, você será capaz de configurar corretamente a integração da sua conta bancária do Banco do Brasil com o BomControle.

Em caso de dúvidas específicas ou situações não cobertas neste manual, não hesite em contatar o suporte do BomControle para orientação.