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.

Pré Requisitos

• Sistema na versão 109.64.5 ou superior 
• Profile V2 homologada do BB
• Certificado digital .PFX
• Extração da chave privada .PEM do certificado
• Extração da chave pública .PEM do certificado

Os certificados autorizados pelo BB para a autenticação mútua são do tipo A1, em formato .pem, com a cadeia inteira (Certificado > Intermediarias > Raiz), emitidos por uma CA válida (ex: Digicert, verisign, ICP Brasil).

Extraindo as chaves do certificado digital

1. Acesse o disco local C em seu computador e crie uma pasta chamada OpenSSL, dentro desta pasta crie uma nova chamada SSL. O diretório deve ser exatamente este: C:\OpenSSL\SSL
2. Faça o download do OpenSSL clicando neste link, a versão é a 1.1 Portable. Extraia da pasta compactada e salve no seu computador no diretório de sua preferência. No exemplo abaixo foi salvo dentro da pasta Documentos: 

Image Removed

Na mesma pasta onde salvou o OpenSSL (a pasta vai ficar com o nome OpenSSL-1.1.1h_win32) coloque o seu certificado digital (caso o nome do certificado tenha espaçamentos na descrição é recomendado que renomeie ele e retire os espaços): 

Image Removed

Abra o terminal openssl como administrador: 

Image Removed

Extraindo a chave pública 

Execute no terminal: 

Onde:

• CertificadoDoProvedor.pfx - substitua pelo nome e extensão do seu certificado digital
• ChavePublica.pem - substitua pelo nome que deseja utilizar para a chave pública

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

Image Removed

Basta informar e então se estiver correta a chave publica vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32.

Image Removed

Extraindo a chave privada

Execute no terminal:

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:

Image Removed

Basta informar e então se estiver correta a chave pública vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32:

Image Removed

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:

Image Removed

Salve desta forma:

Image Removed

Raiz do certificado e certificado intermediário

A cadeia completa contém toda a certificação e hierarquia do certificado digital. Dentro deste arquivo é necessário localizar a raiz e o certificado intermediário.

...

Ao visualizar os certificados instalados na guia Caminho de Certificação é possível identificar facilmente o nome de cada arquivo necessário:

Image Removed

...

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.

Pré Requisitos

• Sistema na versão 109.64.5 ou superior 
• Profile V2 homologada do BB
• Certificado digital .PFX
• Cadeia completa do certificado (pois será necessário utilizar as certificações)
• Extração da chave privada .PEM do certificado
• Extração da chave pública .PEM do certificado

Os certificados autorizados pelo BB para a autenticação mútua são do tipo A1, em formato .pem, com a cadeia inteira (Certificado > Intermediarias > Raiz), emitidos por uma CA válida.

Extraindo as chaves do certificado digital

1. Acesse o disco local C em seu computador e crie uma pasta chamada OpenSSL, dentro desta pasta crie uma nova chamada SSL. O diretório deve ser exatamente este: C:\OpenSSL\SSL
2. Faça o download do OpenSSL clicando neste link, a versão é a 1.1 Portable. Extraia da pasta compactada e salve no seu computador no diretório de sua preferência. No exemplo abaixo foi salvo dentro da pasta Documentos: 

Image Added

Na mesma pasta onde salvou o OpenSSL (a pasta vai ficar com o nome OpenSSL-1.1.1h_win32) coloque o seu certificado digital (caso o nome do certificado tenha espaçamentos na descrição é recomendado que renomeie ele e retire os espaços): 

Image Added

Abra o terminal openssl como administrador: 

Image Added

Extraindo a chave pública 

Execute no terminal: 

Onde:

• CertificadoDoProvedor.pfx - substitua pelo nome e extensão do seu certificado digital
• ChavePublica.pem - substitua pelo nome que deseja utilizar para a chave pública

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

Image Added

Basta informar e então se estiver correta a chave publica vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32.

Image Added

Extraindo a chave privada

Execute no terminal:

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:

Image Added

Basta informar e então se estiver correta a chave pública vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32:

Image Added

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:

Image Added

Salve desta forma:

Image Added

Raiz do certificado e certificado intermediário

• Opção nº 1: solicitar para a entidade certificadora a cadeira completa do certificado digital, dessa forma vai receber os arquivos necessários (certificados raiz e intermediários)
• Opção nº 2: extrair o conteúdo do certificado A1 instalado no seu computador

Extraindo o certificado raiz e intermediários

A cadeia completa contém toda a certificação e hierarquia do certificado digital. Dentro deste arquivo é necessário localizar a raiz e o certificado intermediário, este passo a passo é um exemplo de como obter as informações necessárias:

1. no PC acesse a ferramenta Gerenciar certificados de usuários
2. localize o certificado digital A1 instalado (no exemplo abaixo está no diretório Pessoal > Certificado)
3. clique 2x sobre o certificado e acesse a aba Caminho de Certificação

Image Added

No exemplo abaixo vamos iniciar pela raiz do certificado:

1. selecione e clique na opção Exibir Certificado
2. acesse então a aba Detalhes > Copiar para Arquivo...

Image Added

No assistente para copiar o arquivo selecione a opção X.509 codificado na base 64 (*.cer)

Image Added

Avance e salve o arquivo. Repita o processo com os certificados intermediários.

Montando o conteúdo para o portal do BB

Abra os arquivos certificados raiz e intermediários com um leitor de .txt (como Bloco de Notas, ou Notepad++). Você deve visualizá-los dessa forma:

Image Added

O certificado raiz está pronto para ser utilizado. Já os certificados intermediários precisam ser unificados em um único arquivo. O processo é bem simples, basta copiar e colar o conteúdo no programa leitor de txt (um abaixo do outro) e salvar o registro. Exemplo:

Image Added

Configurações do Pix BB

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:

...

Ao finalizar clique em SOLICITAR PRODUÇÃO, aceite os termos do contrato (ou solicite ao representante da empresa). No canal do YouTube do BB também está disponível um vídeo que explica o processo: Como colocar uma aplicação em produção.: Como colocar uma aplicação em produção.

Credenciais de produção

No menu lateral acesse a opção Credenciais para copiar as informações conforme exemplo abaixo:

Image Added

Veja que na imagem estão selecionadas as credencias de Teste, no seu caso deve estar selecionada a opção Produção. No ERP vão ser utilizados:

• client_id
• client_secret
• developer_application_key

Upload dos certificados

No menu lateral acesse a Certificados e informe o CNPJ do provedor:

...

Acesse então a opção ENVIAR CERTIFICADO:

Image RemovedImage Added

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.

...

• Certificado da empresa - conteúdo da chave pública (extraída do certificado digital);
• Certificado do intermediário - conteúdos copiados dos certificados intermediários;
• Raiz do certificado - conteúdo copiado da raiz do certificado

Abaixo exemplo do portal do BB das informações preenchidas:

Image Added

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.

...

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 Modified

• 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 Modified

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

...