| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Í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.
Pré Requisitos
- Sistema na versão 109.64.5 - MK4 (veja informações sobre a migração em nosso canal no YouTube)
- Profile V2 homologada do Banco do Brasil
- Acesso ao sistema e SAC web em https (recomendado)
- Certificado digital .PFX
- Extração da chave privada .PEM do certificado
- Extração da chave pública .PEM do certificado
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) |
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:
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):
Abra o terminal openssl como administrador:
Extraindo a chave pública
Execute no terminal:
pkcs12 -in "CertificadoDoProvedor.pfx" -nokeys -out "ChavePublica.pem"
Onde:
- CertificadoDigital.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:
Basta informar e então se estiver correta a chave publica vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32.
É esta chave que deve ser enviada para o Sicoob, conforme a documentação Cadastro Pix Sicoob em Homologação.
Extraindo a chave privada
Execute no terminal:
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:
Basta informar e então se estiver correta a chave publica vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32:
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:
É esta chave que será utilizada no upload na profile de pagamento do Sicoob no sistema MK
Configurações do Pix BB
| Informações | ||
|---|---|---|
| ||
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
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:
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:
- Nome da aplicação: descrição identificativa (texto livre);
- Descrição: descrição identificativa (texto livre);
Selecione a opção APIs com contratação online pelo Portal Developers BB e após marque a opção PIX:
Para avançar clique em CRIAR.
No menu Produção preencha os dados e confirme a API escolhida:
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 criar colocar uma aplicação e conseguir suas credenciais - Portal Developers BB | BBm produção.
Configuração da profile de pagamento
...
Após a configuração da conta em produção os dados na profile de pagamento BB v2 deve ser atualizados.
...