Integração PIX

Criado por: Ellem Cristina Ferraciolli

Data de atulização: 11/08/2023

Criamos a Integração PIX, específico para Banco do Brasil.

Primeiramente entre em contato com a nossa equipe para apresentar o interesse em utilizar a integração e realizarmos as devidas liberações.

Criação de Integração Banco do Brasil

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:

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

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

Marcar a flag Gerar Pix na Integração do Banco do Brasil e preencha os campos da seguinte forma:

• URL API (utilizado para realizar as requisições na API de PIX do Banco)

  • Produção: https://api-pix.bb.com.br

• Certificado Digital

  • Certificado Cadastrado no painel da API de PIX do Banco, aceita apenas o formato pfx

• Ocorrência Bancária

  • Ocorrência Bancária que será utilizada pelo retorno do banco

• Credencial

  • Sua AppKey da aba credenciadas no painel da API de PIX do Banco

• Cliente ID

  • client_id da aba credenciadas no painel da API de PIX do Banco

• Cliente Secreto

  • client_secret da aba credenciadas no painel da API de PIX do Banco

• Chave Pix

  • Utilizar a chave PIX cadastrada no Banco

• URL de Autenticação

  • Produção: https://oauth.bb.com.br

• Preencher os campos selecionados abaixo, coloque no campo Gerador de Dígito Verificador: org.brerp.bancosbrasileiros.util.NossoNumeroBB7P, os obrigatórios e a sequência do boleto também:

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:

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

Extraia as informações necessárias e adicione no cadastro, após isso, deverá ser acompanhado a implantação do servidor e aguardar seu status ser igual “Atendido”, indicando que o certificado foi implantado com sucesso, este processo de aprovação leva em torno de 3 dias úteis.

Gerando uma cobrança PIX

Após criada uma Fatura (Cliente), contendo a custódia como Boleto, é possível gerar a cobrança do pix juntamente com o Boleto.

Acesse a Info Gerar Boletos e selecione a integração criada e clique no botão para gerar o boleto:

Assim o boleto será gerada contendo o QrCode para pagamento do PIX:

Será criado um título bancário e este terá associação com a cobrança PIX:

Enquanto estiver ativa, o PIX poderá ser pago normalmente até sua data de expiração.

Invalidando cobrança PIX no BrERP

Caso o boleto bancário seja liquidado ou baixado manualmente, o PIX será removido automaticamente, ficando inválido e com o status "REMOVIDA_PELO_USUARIO_RECEBEDOR”.

Se necessário, poderá utilizar o processo Invalidar Status PIX, este poderá ser executado tanto da janela de cobrança do PIX, quanto do menu:

Lembrando que, mesmo que o PIX seja invalidado, o boleto continuará válido.

Recebendo retorno da cobrança PIX no BrERP

O retorno da cobrança é feita automaticamente, assim que o BrERP receber o retorno do banco que o pix foi pago, será gerado um pagamento e alocado, fazendo com que o título bancário seja pago corretamente e o pix ficará com status da cobrança Concluída e o boleto ficará com o status que foi utilizado configurado na Integração Bancária.