Versões comparadas

Chave

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


Painel
borderColorblack
borderWidth1
borderStylesolid

Índice

Í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
titleDICA

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
iconfalse

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
titlePROFILE BRADESCO

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:

  1. Número da conta:
  2. Razão social: 
  3. CNPJ: 
  4. 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:

Image Modified

Para a integração com o mk responda ao e-mail com estas informações:

  1. Modalidade: cobrança com vencimento
  2. Certificado digital: somente um certificado que será utilizado em ambiente de produção
  3. 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:

Image Modified

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
titleImportante

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:

Image Modified

Pronto! A sua profile Sicoob está com o Pix ativo 😊