Configurações do Pix BB

Cadastro PIX BB em Homologação

Para realizar testes da integração antes de disponibilizar os pagamentos para todos os clientes é possível configurar chaves de homologação. Deve ser utilizada uma conta (profile BB v2) já cadastrada no sistema, só é necessário solicitar o Client ID, Client Secret e Developer Api Key da conta. A solicitação é feita pelo Portal Developers BB . Ao acessar o portal faça a criação da conta de testes preenchendo as seguintes informações:

...

Para avançar clique em CRIAR. Acesse a área Consultar Credenciais para copiar os dados:

 Configuração da profile de pagamento em ambiente de homologação

ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Banco do Brasil e então vai estar disponível a área PIX para inserir a configuração.

...

• Empresa: Em caso de multiempresa podem ser cadastradas credenciais específicas;
• Developer Application Key: Chave adquirida no site do BB;
• Client ID: Chave adquirida no site do BB;
• Cliente Secret: Chave adquirida no site do BB;

Requisitos para o cliente/cadastro utilizado para os testes de pagamento

O Banco do Brasil tem um banco de dados com vários documentos disponíveis para testes. Então pode ser utilizado um cadastro com CPF ou CNPJ válidos. Mas, caso um destes documentos não esteja cadastrado na base do BB o QRcode não será gerado e na ferramenta Transações via Pix vai ficar registrado o retorno de erro: documento inválido.

...

• 96050176876
• 66779051870
• 22902869150
• 97965940132
• 75069056123

 Testes de pagamento

Após inserir as chaves de homologação devem ser realizados alguns testes para verificar a configuração feita e a comunicação entre o mk erp e a API do BB.

 Testar comunicação

Para confirmar que as chaves de homologação estão corretas utilize a ferramenta Testar comunicação:

...

Este teste verifica se as chaves informadas na credencial estão corretas, se são do status selecionado (homologação) e se a comunicação com a API do BB está ok.

 Ativar ferramentas PIX no SAC WEB

Para gerar o teste de pagamento do cliente selecionado na profile em homologação o PIX deve ser ativo no SAC WEB. Veja na documentação: Habilitar/Desabilitar pagamentos por PIX no SAC WEB

 Testar a linha de pagamento gerada pelo QRcode

Para que o BB faça a análise da linha de pagamento o QRcode para uma fatura do cliente em homologação deve ser gerado no SAC e então a linha pode ser copiada. Veja na documentação: Efetuar pagamentos pelo SAC WEB

...

Cadastro PIX BB

...

Após realizar os testes de pagamento as chaves podem ser alteradas para as de produção. O suporte do BB disponibiliza o manual abaixo com o passo e o seu gerente de contas também pode auxiliar:

...

No canal do YouTube do BB também está disponível um vídeo que explica o processo: Como criar uma aplicação e conseguir suas credenciais - Portal Developers BB | BB.

...

Configuração da profile de pagamento em ambiente de produção

Após a configuração da conta em produção os dados na profile de pagamento BB v2 deve ser atualizados.

...

• Chave PIX: Em ambiente de Produção, o cliente deve criar sua própria chave através de seu Internet Banking. É essa chave que vai ser informada no MK (recomendamos que utilize a opção de gerar chave aleatória);
• Credenciais: Seleção da credencial utilizada na conta/profile de pagamento. Clique em Cadastrar credenciais PIX para alterar os dados para as novas chaves de produção;
• Status: agora selecione a opção:
  
  • Produção - Para quando a integração estiver em produção de fato (com a chave pix e credenciais de produção);
• Hab. testes: Não;
• Cliente Homologação: Retire o cadastro do cliente;
• Testar comunicação: Teste de comunicação com o BB para confirmar se a chave e credenciais estão corretas;
• Cadastrar credenciais PIX: ao clicar neste botão será aberta nova janela onde deve ser inserida a configuração com as novas chaves de produção;