| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Índice
|
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ú
| Informações | ||
|---|---|---|
| ||
Atenção! Caso não tenha nenhuma profile do Itaú no layout v2 homologada em seu sistema entre em contato com a equipe de suporte a homologação bancária para iniciar o processo. |
...
| Informações | ||
|---|---|---|
| ||
A equipe de desenvolvimento do mk erp já fez testes de pagamento com o Itaú durante a criação da integração, por isso o sistema é considerado como já homologado. Durante a solicitação da integração informe/selecione no internet banking os dados do ambiente virtual de produção, dessa forma já vai receber as informações válidas. |
Geração do certificado .CSR
O processo de uso da API Pix do Itaú exige que o provedor utilize um certificado específico .CER 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.
...
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:
| Informações | ||
|---|---|---|
| ||
O cadastro dos dados é de responsabilidade exclusiva do provedor! |
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 .CER 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 😊