IMPORTANTE: Os passos aqui descritos são mera complementação e/ou resumo da documentação oficial do BB. Sigam sempre as instrução oficiais passadas pelo banco. Nem todas as informações aqui contidas podem estar atualizadas (última revisão 06/09/2023).

NOTA: O suporte da API não cobre o uso/cadastro/coleta de informações junto ao banco.

A inicialização do PIX com o BB deve seguir os seguintes passos:

1. Crie uma conta no portal de desenvolvedores do BB: https://app.developers.bb.com.br/#/login
2. Crie uma nova aplicação, e ative as APIs de Cobrança e PIX:
   1. O “URI de Callback” e Ícone podem ficar em branco;
3. Selecione a aplicação e no item do menu “Credenciais” ( https://app.developers.bb.com.br/#/menu/credenciais ) consulte os dados de acesso: “developer_application_key“, “client_id” e “client_secret“;
4. De posse das informações acima você poderá inicializar a API no Maker;
5. No fluxo que vai acionar a API crie um mapa com os itens correspondente no site do BB:
   1. “developer_application_key” (Letras): Obter no site do BB;
   2. “client_id” (Letras): Obter no site do BB;
   3. “client_secret” (Letras): Obter no site do BB;
   4. CERTIFICADO_PFX (Letras): Caminho completo do certificado em formato PFX (PKCS12);
   5. CERTIFICADO_SENHA (Letras): Senha do certificado;
   6. “access_token” (Letras) – (Opcional) Pode ser usado no lugar dos dois parâmetros “client_id” e “client_secret“;
   7. “RECEBEDOR_NOME” (Letras) – Nome do recebedor;
   8. “RECEBEDOR_CIDADE” (Letras) – Cidade do recebedor;
   9. “SERVIDOR_OAUTH_HOMOLOGACAO” (Letras): opcional, padrão “oauth.sandbox.bb.com.br”;
   10. “SERVIDOR_HOMOLOGACAO” (Letras): opcional, padrão: “api.sandbox.bb.com.br”;
   11. “BB_VERSAO” (Letras): (Opcional) Versão da API do PIX a ser utilizada, padrão “V2“, informar “V1” para usar a versão antiga.
6. Na função “PIX – Inicializar” passe os seguintes parâmetros:
   1. Falso (Para homologação);
   2. “BB” (Letras) – Texto fixo que identifica o Banco do Brasil;
   3. Mapa com os dados copiados do site do BB.
7. Para a criação do PIX informe uma das chaves de testes:
   • Versão 2:
     • “hmtestes2@bb.com.br“;
   • Versão 1:
     1. “testqrcode01@bb.com.br“;
     2. “28779295827“;
     3. “7f6844d0-de89-47e5-9ef7-e0a35a681615“;
     4. “3d94a38b-f344-460e-b6c9-489469b2fb03“;
     5. “d14d32de-b3b9-4c31-9f89-8df2cec92c50“.
8. Após homologar/testar em desenvolvimento você poderá pedir os dados de produção.