API Banco do Brasil
Passo a passo de como fazer o cadastro para utilizar as APIs do Banco do Brasil.
1° Passo - Criar conta no BB For Developers
Criar uma conta no BB For Developers. Acessar Link: https://www.bb.com.br/site/developers/
2° Passo - Clicar em Cadastra-se
3° Passo - Tela Inicial Conta
Com a conta no site criada, você será redirecionado para a tela dos dados dos aplicativo ativos que você possui.
Para o próximo passo basta selecionar o aplicativo, no meu caso é o "Teste cobrança". Mas como será o seu primeiro acesso basta clicar em "Nova Aplicação". Você será redirecionado para a tela de criação de uma nova aplicação, basta informar os dados (Nome, Descrição e icone. Icones são opcionais).
Logo abaixo você deve selecionar quais APIs o seu aplicativo ira obter, os aplicativos podem possuir APIs de cobranças ou pagamentos.
Com o aplicativo selecionado basta ir na barra de menus no canto esquerdo.
Para obter as credenciais para poder realizar os testes ou até mesmo as credencias de produção, basta clicar em credenciais.
4° Passo - Acessar Documentação e Ambiente de Teste
Para acessar a documentação ou ambiente de teste, basta voltar para o Dashboard inicial clicando na barra de menus ao lado esquerdo e ir em "Dashboard". No Dashboard basta ir em "Documentação" ou "SandBox" (Para o ambiente de teste).
Ao clicar em "Documentação", para obter os dados de teste, basta ir ao menu lateral esquerdo e clicar em "API Cobrança -> Homologação e testes" (Dados da API de cobrança) por exemplo.
Ao acessar essa aba ao rolar para baixo você tem acesso aos dados fictícios, como também, exemplo de como montar a requisição.
Ao clicar em "SandBox", para obter acesso ao ambiente de testes do Banco do Brasil, basta ir ao menu lateral esquerdo e clicar em "API'S" e escolher a API que deseja testar, você pode utilizar o ambiente de testes para entender o processo ou ir direto ao ERP.
Ao clicar em "Cobrança" por exemplo, a tela abaixo será exibida:
Porém, antes de utilizar a API você precisa Autorizar as suas credenciais, basta clicar em "Authorize":
Basta informar o seu Client-Id e Client-Secret e selecionar os escopos a ser utilizado, pode selecionar os dois escopos, pois será necessário para utilizar nos testes. Após isso basta autorizar.
5° Passo - Produção
Para colocar a aplicação em Produção basta ir na barra de menus no canto esquerdo e clicar em Produção.
Ao clicar a tela de inicio para colocar o aplicativo em produção será exibida, basta seguir os passos.
6° Passo - Configurar WebHook ERP
Para o funcionamento do webhook é necessário algumas informações no ERP:
Informar o número de convenio da conta e também a quantidade de dias acordada na contratação do convenio para a data de crédito, considerando feriados e finais de semana.
É necessário informar no cadastro de banco o código da ocorrência que vai ser utilizada para a baixa operacional das cobranças recebidas no evento do webhook:
Já nas informações da aplicação, é preciso informar as informações do banco de dados para funcionamento da aplicação, que se encontra na pasta XmlConfig no arquivo WH_DpSettings.xml:
Já no arquivo web.config é preciso parametrizar o caminho do arquivo de configurações e também aonde o arquivo de log será gerado, e um usuário para ser utilizado no log de alterações do movimento que será gerado:
7° Passo - Configurar WebHook Banco do Brasil
Na plataforma do Banco do Brasil é preciso seguir os seguintes passos:
Entrar no aplicativo, clicar no menu lateral esquerdo em webhook:
Clicar em Cadastrar Evento e inserir as informações necessárias para o funcionamento, assim como escolher a API a ser utilizada, o convenio, a URL de callback e o email para notificações de problemas e o tipo de evento.
Segue os IPs externos utilizados pelo Webhook dos 2 datacenters do banco do brasil:
CCT1: 170.66.14.184 CCT2: 170.66.196.181 / 170.66.196.114 - 115