Visão geral

O MK erp possui integração com a API do Pix Itaú, o que viabiliza a realização de pagamentos (QRcode e pix copia e cola) pelo SAC WEB e app do SAC Plus+. Nesta modalidade os valores Pix pagos pelos clientes são depositados diretamente na conta corrente do provedor.

Com esta integração será possível: 

• Disponibilizar QRcode para pagamentos dos clientes
• Disponibilizar a linha do QRcode para pagamentos dos clientes (na modalidade/opção de pagamento PIX COPIA E COLA)
• Receber pagamentos dos clientes automaticamente
• Acompanhar as transações (geração do QRCode, pagamentos efetivados e rejeitados)

Pré Requisitos

• Sistema na versão 109.60 - MK4 (veja informações sobre a migração em nosso canal no YouTube)
• Profile V2 homologada do Itaú
• Acesso ao sistema e SAC web em https (recomendado)
• Processo de onboarding e geração dos certificados com a equipe de integrações do Itaú

Configurações de adesão

O primeiro passo é iniciar a jornada de adesão junto com o a equipe do Itaú. Entre em contato com o banco e solicite a adesão com a integração API Pix que as tratativas serão executadas via email.

Geração do certificado .CSR

O processo de uso da API Pix do Itaú exige que o provedor utilize um certificado específico .CRT para utilização no internet banking e mk erp. Este certificado é gerado pelo banco após o envio de um certificado .CSR que deve ser gerado pelo provedor. Nesta documentação vamos passar sugestões para que faça a geração dos arquivos necessários.

1. Acesse o disco local C em seu computador e crie uma pasta chamada OpenSSL
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 na pasta criada:

1. Crie uma nova pasta chamada SSL (o diretório deve ser exatamente C:\OpenSSL\SSL)
2. Volte na pasta onde a ferramenta foi extraída, copie o arquivo ‘openssl.cnf’ e cole na pasta SSL:

Retorne para a pasta onde extraiu o programa e execute o terminal openssl como administrador:

Gerando o arquivo de chave

Execute no terminal:

Será solicitada uma senha para gerar o arquivo de chaves, informe a senha que desejar e após confirme a senha. Dica: anote/decore ele pois será utilizada novamente.

Gerando a requisição do certificado

Será solicitada a senha registrada anteriormente, basta digitar ela e então executar no terminal:

E após preencher as informações:

• BR
• Estado
• Cidade
• Itau
• Nome/Descrição do provedor
• Client_id (informar aqui a credencial ‘client_id’ enviado pelo Itaú)
• Email
• Enter (para pular esta etapa)
• Enter (para pular esta etapa)
• Enter (para pular esta etapa)

Retirando a senha do certificado

Nessa etapa, se a extração estiver sendo executada pelo Windowns, a chave pode ser renomeada manualmente. Já se estiver utilizando o Linux, execute no terminal:

Logo após, execute no terminal o comando:

Pronto! O certificado foi gerado, ele fica salvo dentro da pasta OpenSSL-1.1.1h_win32

Solicitação de certificado .CRT

A api pix do Itaú disponibiliza um endpoint para tratar das solicitações dos certificados, ele exige que sejam informados o o token temporário e o certificado.csr para retornar a credencial (cliente_secret) e o certificado definitivo no formato .crt.

ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Itaú e então vai estar disponível a área PIX para inserir a configuração. Clique na opção Cadastrar Credenciais Pix e na nova tela, na opção Gerenciar certificados:

Na nova tela é necessário informar o token temporário (enviado por email pelo Itaú) e fazer o upload do arquivo .csr:

Finalizado esse processo, a solicitação retorna com a credencial cliente_secret e o certificado.crt, e a rotina então atualiza de forma automática o primeiro campo na grade das credenciais.

Configuração da profile de pagamento

ACESSO: Configurações → Menu Financeiro → Submenu Profile de Pagamento → Boleto MK Ver. 2 - Edição, localize a profile do Itaú e então vai estar disponível a área PIX para inserir a configuração:

Preencha os seguintes campos:

• Chave PIX: chave Pix da conta Itaú (gerada pelo Itaú e enviada por e-mail, pode ser o CNPJ, um e-mail, telefone, chave aleatória... verifique com o seu gerente)
• 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: caso deseje efetuar testes de pagamento selecione o cliente que será utilizado (o QRcode só será gerado para ele);
• Testar comunicação: teste de comunicação com o Itaú 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 novas chaves de produção;

• client_id: credencial de produção enviada pelo Itaú por email;
• client_secret: credencial de produção atualizada de forma automática no campo após solicitação do certificado;
• path_cert_client: certificado .CRT que fica disponível para download após solicitação do certificado;
• path_key_cliente: chave privada que foi gerada junto com o certificado .crs no primeiro passo.

 Testar comunicação

Para confirmar que as chaves de homologação estão corretas utilize a ferramenta Testar comunicação:

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