| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Índice
|
Visão geral
O MK erp possui integração com a API do Pix Bradesco. Nesta modalidade os valores Pix pagos pelos clientes são depositados diretamente na conta corrente do provedor. O processo de uso da API Pix do Bradesco exige que o provedor gere certificados específicos que devem ser enviados para o gerente e upados 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.57 - MK4 (veja informações sobre a migração em nosso canal no YouTube)
- Profile V2 homologada do Bradesco
- Acesso ao sistema e SAC web em https (recomendado)
- Certificado digital .PFX com o mesmo CNPJ da conta Bradesco e validade de no mínimo 12 meses
- Extração da chave privada .PEM do certificado
- Extração da chave pública .PEM do certificado
Extraindo as chaves do certificado digital
| Informações | ||
|---|---|---|
| ||
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. |
...
Abra o terminal openssl como administrador:
Extraindo a chave pública
Execute no terminal:
| Informações | ||
|---|---|---|
| ||
pkcs12 -in "CertificadoDoProvedor.pfx" -nokeys -out "ChavePublica.pem" |
...
É esta chave que deve ser enviada para o Bradesco, conforme a documentação Cadastro Pix Bradesco em Homologação.
Extraindo a chave privada
Execute no terminal:
| 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:
...
É esta chave que será utilizada no upload na profile de pagamento do Bradesco no sistema MK.
Cadastro Pix Bradesco
A equipe de desenvolvimento do mk erp já fez testes de pagamento com o Bradesco durante a criação da integração, por isso o sistema é considerado como já homologado. Assim basta solicitar para a agência as chaves de produção para inserir na profile. Deve ser utilizada uma conta (profile Bradesco v2) já cadastrada no sistema.
| Informações | ||
|---|---|---|
| ||
Atenção! Caso não tenha nenhuma profile do Bradesco no layout v2 homologada em seu sistema entre em contato com a equipe de suporte a homologação bancária para iniciar o processo. |
É necessário inserir os dados PIX passados pela agência, entre em contato com o seu gerente para solicitar as informações. A solicitação deve ser de credenciais de produção da API PIX (QRcode dinâmico/pix copia e cola), e geralmente são solicitados os seguintes dados do provedor:
- Número da conta:
- Razão social:
- CNPJ:
- E-mail:
Os dados serão encaminhados para a área de operações de negócios que vai na sequência enviar um e-mail com instruções:
Para a integração com o mk responda ao e-mail com estas informações:
- Modalidade: cobrança com vencimento
- Certificado digital: somente um certificado que será utilizado em ambiente de produção
- Credenciais: produção
E anexe a chave pública extraída do certificado digital (se foi seguido o passo a passo da documentação estará salvo no computador com o nome ChavePublica.pem). A seguir será enviado o contrato com os termos da API PIX e após assinatura a equipe de suporte de APIs Bradesco vai enviar o client_id e client_secret em um arquivo (por questões de segurança o arquivo é enviado em um e-mail separado, protegido por senha que é enviada para o e-mail informado como responsável no contrato).
Para finalizar a integração o time do Bradesco vai enviar uma confirmação por e-mail com os dados do gerente que será responsável pela conta:
Configuração da profile de pagamento em ambiente de produção
ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Bradesco e então vai estar disponível a área PIX para inserir a configuração:
| Informações | ||
|---|---|---|
| ||
O cadastro dos dados de produção é de responsabilidade exclusiva do provedor! |
Preencha os seguintes campos:
- Chave PIX: chave Pix da conta Bradesco, consultada/cadastrada no internet banking do Bradesco (menu Net Empresa> Pix), se tiver dúvidas na geração consulte o seu gerente de conta;
- 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 Bradesco para confirmar se a chave e credenciais estão corretas (clique para executar somente após inserir os dados conforme instruções abaixo);
- 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;
- client_id: credencial de produção enviada pelo Bradesco;
- client_secret: credencial de produção enviada pelo Bradesco;
- path_cert_host: certificado digital público do host da api Pix do Bradesco (pode fazer o download clicando aqui e após basta fazer o upload no sistema);
- path_cert_client: chave pública .PEM extraída do certificado digital do provedor (a mesma que foi enviada para o Bradesco gerar as credenciais);
- path_key_cliente: 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:
Pronto! A sua profile Sicoob está com o Pix ativo 😊