Í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 a chave do certificado digital
- 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
- 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:
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:
Basta informar e então se estiver correta a chave publica vai ser criada dentro da mesma pasta OpenSSL-1.1.1h_win32.
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:
Basta informar e então se estiver correta a chave pública 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:
Extraindo a cadeia de certificados
Execute no terminal:
Configurações do Pix BB
PROFILE 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:
- 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 colocar uma aplicação em produção.
Upload dos certificados
No menu lateral acesse a Certificados e informe o CNPJ do provedor:
Acesse então a opção ENVIAR CERTIFICADO:
A empresa será identificada pelo nome e as áreas para inserção dos conteúdos dos certificados vão ficar disponíveis:
- Certificado da empresa -
- 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.
Se estiver tudo certo com os dados a tela vai ser atualizada:
E quando os certificados forem aceitos a situação vai ser alterada:
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.
ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Banco do Brasil e então vai estar disponível a área PIX para inserir a configuração:
Importante
O cadastro dos dados de homologação e de produção é de responsabilidade exclusiva do provedor
Altere os seguintes campos:
- Chave PIX: Em ambiente de Produção, o cliente deve criar sua própria chave através de seu Internet Banking. É essa chave que vai ser informada no MK (recomendamos que utilize a opção de gerar chave aleatória);
- Credenciais: Seleção da credencial utilizada na conta/profile de pagamento. Clique em Cadastrar credenciais PIX para alterar os dados para as novas chaves de produção;
- Status: agora selecione a opção:
- Produção - Para quando a integração estiver em produção de fato (com a chave pix e credenciais de produção);
- Hab. testes: Não;
- Cliente Homologação: Retire o cadastro do cliente;
- Testar comunicação: Teste de comunicação com o BB para confirmar se a chave e credenciais estão corretas;
- Cadastrar credenciais PIX: ao clicar neste botão será aberta nova janela onde deve ser inserida a configuração com as novas chaves de produção;