001 - Banco do Brasil
{: height="50px" width="200px"}
→Acesse e cadastre-se no Portal BB for Developers:
É muito simples. Na landing page do Portal BB for Developers (se preferir, acesse Aqui) acione a transação Cadastre-se e preencha os seguintes dados: CPF, nome da mãe, data de nascimento, endereço de e-mail e número de celular válidos.
Desconsidere acentuações e caracteres especiais.
Será remetido um código de confirmação para o número de telefone cadastrado no Banco. Informe o código recebido e cadastre uma senha conforme instruções indicadas em tela. Caso você tenha recebido um e-mail com convite do BB para primeiro ingresso no Portal BB for Developers, após o primeiro acesso, informe a chave/código indicada na mensagem.
→Crie sua aplicação:
Uma vez cadastrado no Portal BB for Developers será exigida a criação de uma aplicação. Acesse o contêiner (“+ Nova Aplicação”) e atribua as seguintes informações: nome da aplicação, descrição, URL de imagem para ícone da área de desenvolvimento (não obrigatório) e URI de call-back. Criada a aplicação, clique sobre o contêiner do app para acessar a área do desenvolvedor. As credenciais necessárias para realização dos testes são geradas automaticamente neste momento e poderão ser identificadas na opção Credenciais do menu lateral esquerdo. Caso persista alguma dúvida com relação às credenciais geradas ou os fluxos de autorização envolvidos nos processos clique Aqui ou acesse, através do link Documentos, o item Segurança. Dentro da área do desenvolver é possível acompanhar as estatísticas decorrentes dos testes executados, incluir outros desenvolvedores para trabalhar no projeto, gerenciar o time de desenvolvimento, identificar e manusear o client secret e client id gerados pelo sistema para permitir os testes, acessar o Swagger e outros documentos técnicos detalhados da API em desenvolvimento, excluir a aplicação ou colocá-la em produção.
→Credenciais:
Para realizar requisições nos recursos das APIs, é necessário gerar um Access Token (access_token).
Em ambiente de Teste, o primeiro item disponibilizado, o “developer_application_key”, deverá ser informado como parâmetro gw-dev-app-key nas APIs. (ex: api.sandbox.bb.com.br/api/v2/recurso?gw-dev-app-key).
Logo abaixo, seguem as credenciais OAuth, as quais deverão ser utilizadas para gerar o Access Token. Para facilitar ainda mais, disponibilizamos o Basic do Authorization – basta copiá-lo (botão “Copiar Basic”).
→Realizando chamada aos Recursos da API:
Com domínio do Access Token e da documentação disponível da API, você conseguirá realizar todas as requisições necessárias ao desenvolvimento da aplicação e realização dos testes no aplicativo Postman. Recomendamos que após realizar as requisições com sucesso seja iniciada a implementação no código fonte da sua aplicação, assim como de todo o front end necessário para que sua empresa ou os seus clientes possam usufruir da experiência negocial desenhada e esperada. Acesse informações mais detalhadas através do link Documentos do Portal BB for Developers, no item Segurança.
→Enviando a sua aplicação para Produção:
Para utilizar as APIs do BB no seu negócio, é necessário o envio da sua aplicação para Produção. Recomendamos realizar o envio após finalização dos testes descritos no item anterior.
»Passo 7.1
Selecione qual aplicação você deseja enviar para produção. É importante lembrar que a aplicação devera estar com status “Em desenvolvimento”.
»Passo 7.2
No menu lateral, selecione a opção “Produção” e siga os passos: Informe o CNPJ da empresa responsável. Revise as informações da sua aplicação. Caso a sua aplicação tenha a API de Cobrança vinculada, a contratação poderá ser feita de 2 formas: com ou sem o contato do BB.
A contratação é feita sem a interferência do BB, caso a empresa já possua contratado um convênio de cobrança e este esteja ativo. Caso não tenha aguarde o Banco do Brasil entrar em contato com você para finalizar a contratação, e sua aplicação ficará com o status de “Aguardando aprovação”. Após o envio da sua aplicação para produção o status será alterado para “Aprovado”.
→Gerando credenciais para produção:
Selecione qual aplicação você deseja enviar para produção. É importante lembrar que a aplicação deve estar com seu status Em desenvolvimento. Na área do desenvolvedor, acesse a transação Produção no menu lateral esquerdo, informe o CNPJ da empresa responsável, revise os dados da aplicação e comande a disponibilização.
Neste meio tempo sua aplicação permanecerá com status Aguardando aprovação. Após envio da aplicação para produção e retirada de pendência pelos outorgados, o status será alterado para Aprovado.
Verifique se o item Produção ficou selecionado em azul. Informe “developer_application_key” como parâmetro gw-dev-app-key nas APIs. Utilize as credenciais OAuth para criar seu o Access Token.
Nas chamadas da API, o atributo gw-dev-app-key deve preferencialmente ser enviado com o dev app key do software que está integrando a solução. Caso não seja possível, excepcionalmente a dev app key gerada na aplicação do cliente pode ser utilizada.
→Fazendo as requisições no ambiente de produção:
É imprescindível a vinculação de um convênio de prestação de serviço ativo para que a integração seja eficaz. Caso a empresa integrada já detenha convênio contratado os dados deste deverão ser informados no procedimento de requisição dos serviços. Caso não tenha, aguarde o BB contatá-lo para contratação. Importante: Lembre-se de alterar o endpoints das APIs para produção. Todos os dados informados em Produção, são dados reais. Nas APIs aplicáveis, sugerimos realizar transações de valores irrisórios, como exemplo de realizar a geração do boleto de R$ 0,01 ou um débito em conta nesse valor.
caso tenha dúvidas acesse o portal do BB: https://apoio.developers.bb.com.br/referency/post/5f4f8129b71fb5001268c99d