Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.


Painel
borderColorblack
borderWidth1
borderStylesolid

Índice

Índice

O MK erp possui integração com a API do Pix Banco do Brasil V2. Nesta modalidade os valores Pix pagos pelos clientes são depositados diretamente na conta corrente do provedor. O processo de uso da API Pix V2 do BB exige que o provedor gere certificados específicos que devem ser utilizado no internet banking e no mk erp. Nesta documentação vamos passar sugestões para que faça a geração destes certificados e como ativar a configuração da profile de pagamento.

Extraindo

...

as chaves do certificado digital

Dica
Não é obrigatório seguir este modelo para exportação das chaves, caso tenha conhecimento de outras formas de geração, pode ignorar as etapas abaixo. Documentação de auxílio do Banco do Brasil: Autenticação Mútua de Certificados (MTLS)

...

Informações
pkcs12 -in "CertificadoDoProvedor.pfx" -nocerts -out "ChavePrivada.pem" -nodes

Onde:

  • CertificadoDoProvedor.pfx - substitua pelo nome e extensão do seu certificado digital
  • ChavePrivada.pem - substitua pelo nome que deseja utilizar para a chave privada

Após rodar o comando o terminal vai solicitar a senha do certificado:

...

Abra o arquivo (pode utilizar o Bloco de Notas, Notepad++ ou qualquer programa que leia arquivos .txt) e remova o cabeçalho: linhas 1,2 e 3, conforme exemplos abaixo:

Salve desta forma:

...

Execute no terminal:

Informações
pkcs12 -in "21407345.pfx" -cacerts -nokeys -chain -out "CadeiaCertificados.cer"

Configurações do Pix BB

Informações
titlePROFILE BB

Atenção! Caso não tenha nenhuma profile do Banco do Brasil no layout v2 homologada em seu sistema entre em contato com a equipe de suporte a homologação bancária para iniciar o processo.

Cadastro PIX BB em Produçã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:

...

A empresa será identificada pelo nome e as áreas para inserção dos conteúdos dos certificados vão ficar disponíveis. Atenção: em cada campo o conteúdo dos certificados deve ser copiado e colado.

Dica

Abra os arquivos dos certificados com um leitor de .txt como Bloco de Notas, ou Notepad++ e então copie todo o conteúdo do certificado. É este conteúdo que deve ser utilizado nos campos abaixo.


  • Certificado da empresa - conteúdo da chave pública (extraída do certificado digital);
  • Certificado do intermediário - 
  • Raiz do certificado -

Após clicar em SALVAR o portal do BB vai verificar se os dados estão corretos. Caso exista alguma inconsistência uma mensagem vai informar qual dos certificados deve ser ajustado.

...

Informações
titleImportante

O cadastro dos dados de homologação e de produção é de responsabilidade exclusiva do responsabilidade exclusiva do provedor!

Altere Preencha os seguintes campos:

  • Chave PIX:

...

  • chave da conta do Banco do Brasil adquirida no site do BB (pode ser o CNPJ, um e-mail, telefone, chave aleatória...). 
  • Credenciais: 

...

  • seleção da credencial utilizada na conta/profile de pagamento. Clique

...

  • em Cadastrar credenciais PIX para

...

  • inserir os dados

...

  • de produção;
  • Status: 

...

  • selecione a opção:
    • Produção

...

  • Hab. testes:
    • Sim: pode utilizar esta opção para realizar um teste de pagamento, dessa forma a geração do QRcode vai ser permitida somente para um cadastro selecionado como Cliente Homologação;
    • Não: liberado para todos os clientes;
  • Cliente Homologação: 

...

  • selecione o cadastro do cliente que deseja utilizar para o teste de pagamento;
  • Testar comunicação: 

...

  • teste de comunicação com o

...

  • Sicoob para confirmar se a chave e credenciais estão corretas (clique para executar somente após inserir os dados conforme instruções abaixo);
  • Versão API: selecione a opção 'Versão 2'
  • Cadastrar credenciais PIX: ao clicar neste botão será aberta nova janela onde deve ser inserida a configuração

...

  • com as chaves de produção;

Image Added

  • client_id - chave adquirida no site do BB;
  • client_secret - chave adquirida no site do BB;
  • developer_application_key -chave adquirida no site do BB;
  • path_cert_client - chave pública .PEM extraída do certificado digital do provedor;
  • path_key_client - chave privada .PEM extraída do certificado digital do provedor

Testar comunicação

Para confirmar que as credenciais estão corretas utilize a ferramenta Testar comunicação:

Image Added

Este teste verifica se as chaves informadas na credencial estão certas e se os certificados tiveram o upload feito corretamente!


Informações
iconfalse

Pronto! A sua profile está em produção! Veja as configurações, ferramentas e recursos que pode utilizar: Pagamentos via PIX

...