Pular para o conteúdo principal

Configuração Integração PIX

important

Caso ainda não tenha contratado a Integração PIX e possua interesse, entre em contato com a nossa equipe para realizarmos as devidas liberações.

dica

Confira nosso guia de uso da Integração PIX na documentação Integração PIX.

Para realizar a configuração siga os passos a seguir:

Acessar o link https://app.developers.bb.com.br/ e criar um cadastro, em produção só poderá utilizar CNPJ.

Crie uma aplicação PIX:

PIX

Acesse a integração criada, vá à opção Credenciais e colete as informações.

Enviar Certificado para o Banco do Brasil​

Para garantir o sucesso das requisições, é fundamental que o certificado enviado seja idêntico ao cadastrado no painel da API do PIX para o envio do certificado para o banco seguiremos os passos abaixo:

No Painel da Aplicação faça:

  1. Clique na opção CERTIFICADOS na lateral esquerda e depois no botão ENVIAR CERTIFICADO, conforme imagem abaixo:

PIX

  1. No terminal, onde você já está com seu certificado em formato PFX digite os comandos abaixo para extrair a chave pública e o CA, conforme imagem abaixo:

PIX

nota

Caso não consiga extrair o CA.CER, você pode instalar na máquina e exportar novamente e recomeçar a extração.

As setas em vermelho ilustram o arquivo que será gerado após cada comando, note que cada comando exigirá que se informe a senha do certificado, que foi definida no processo de conversão de CERT para PFX.

PIX

  1. Visualize o conteúdo do arquivo “chave_publica.cer” e copie o texto para o bloco de notas, (incluindo as linhas —–BEGIN CERTIFICATE—– e também —–END CERTIFICATE—–) conforme imagem abaixo:

PIX

  1. Visualize o conteúdo do arquivo “ca.cer” e copie os textos para o bloco de notas conforme imagem abaixo (note que agora são duas seções que deverão ser copiadas):

PIX PIX

  1. Agora é só colar o conteúdo dos blocos de notas (deverá existir 3 blocos de notas com conteúdos copiados) nos campos, de acordo com a numeração das imagens e clicar no botão SALVAR.

PIX

Após isso, deverá ser acompanhada a implantação do servidor e aguardar seu status ser igual “Atendido”, indicando que o certificado foi implantado com sucesso.

nota

Este processo de aprovação leva em torno de 3 dias úteis.

Configuração Integração Bancária PIX​

Com a flag Gerar Pix marcada, os campos abaixo deverão ser preenchidos da seguinte forma:

  • Integração PIX
    • ‘Banco do Brasil’;
  • Ambiente
    • (Homologação ou Produção);
  • Ocorrência Bancária
    • Ocorrência Bancária que será utilizada pelo retorno do banco;
  • Certificado Digital
    • Certificado Cadastrado no painel da API de Pix do Banco, aceita apenas o formato pfx;
  • Tipo de Documento
    • Preencher com o TdD que o Recebimento receberá quando houver pagamento de um PIX avulso;
  • Credencial
    • Sua AppKey da aba credenciadas no painel da API de Pix do Banco;
  • Client ID
    • client_id da aba credenciadas no painel da API de PIX do Banco;
  • Client Secret
    • client_secret da aba credenciadas no painel da API de Pix do Banco;
  • URL Retorno
    • Informar URL do BrERP para retorno das notificações do serviço de webhook, que estará vinculada à chave Piindicada na chamada;
  • Evento Webhook Enviado
    • Indica se a URL de retorno já foi enviada ao banco;
  • Token
    • Será preenchido automaticamente na comunicação com a API do Pix;
  • Expira em
    • Automaticamente preenchido com data e hora do vencimento do Token;
  • Integração PIX Válida
    • Indica se a Integração Pix está válida;
  • Chave Pix
    • Utilizar a chave Pix cadastrada no Banco;
  • Centro de Custo
    • Informe o Centro de Custo que a Cobrança PIX e Recebimento deverão receber ao serem gerados a partir desta integração.

PIX