Visão geral

O MK erp possui integração com a API do Pix Sicredi, 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
• Receber pagamentos dos clientes automaticamente
• Acompanhar as transações (geração do QRCode, pagamentos efetivados e rejeitados)

Pré Requisitos

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

Configurações

O primeiro passo é iniciar a jornada de adesão junto com o a equipe do Sicredi. Entre em contato com a cooperativa (o gerente da sua conta pode lhe encaminhar para o setor responsável) e solicite a adesão com a integração API Pix.

Informações sobre o mk erp que serão solicitadas pelo Sicredi (em destaque as respostas que devem ser enviadas):

...

A equipe de onboarding vai enviar por e-mail o passo a passo para geração do certificado.

Geração do certificado .CSR

O processo de uso da API Pix do Sicredi exige que o provedor utilize um certificado específico .CER 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.

...

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

Gerando o arquivo de chave

Execute no terminal:

genrsa -des3 -out mkSicredi.key 2048

...

Gerando a requisição do certificado

Será solicitada a senha registrada anteriormente, basta digitar ela e então os comandos abaixo devem ser informados (são dados do Sicredi e do provedor, o que deve ser alterado está em destaque):

...

• BR
• Rio Grande do Sul
• Porto Alegre
• Confederacao Interestadual das Cooperativas Ligadas ao Sicredi
• API PIX Sicredi
• api-pix-NOMEDOPROVEDOR
• EMAIL DO ASSOCIADO
• Enter (para pular esta etapa)
• Enter (para pular esta etapa)

Retirando a senha do certificado

Execute no terminal:

...

E após execute:

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

...

• mkSicrediCSR.csr - este certificado deve ser enviado para o Sicredi, por upload no internet banking, conforme o manual da cartilha de integração;
• mkSicrediFinal.key - guarde este certificado para fazer upload na profile do Sicredi.

Próximos passos

Após o upload no internet banking eles vão analisar o certificado .CSR enviado e então disponibilizar o certificado .CER assinado que de fato será usado na integração com o mk erp. O SLA para disponibilização do certificado é de 3 dias úteis. É necessário aguardar este envio para seguir com a configuração da profile no sistema. Siga as etapas 1,2 e 4 do manual do Sicredi para fazer o upload, obter o certificado .CER e as credenciais. A ETAPA 1 descreve como deve ser feito o upload do mkSicrediCSR.csr:

...

A ETAPA 2 descreve o processo de análise/assinatura do Sicredi, o arquivo .CER será disponibilizado em alguns dias (o SLA do Sicredi é de 3 dias para análise deste certificado):

A equipe de desenvolvimento do mk erp já fez testes de pagamento com o Sicredi 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. A ETAPA 4 informa os passos finais e direciona para a seleção do certificado já aprovado para gerar as credenciais do ambiente de produção.

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 Sicredi 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 Sicoob (gerada pelo Sicoob e enviada para o cooperado 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: 
• Testar comunicação: teste de comunicação com o Sicoob 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 Sicredi;
• client_secret: credencial de produção enviada pelo Sicredi;
• path_cert_host: certificado digital público do host da api Pix do Sicredi (pode fazer o download clicando aqui e após basta fazer o upload no sistema);
• path_cert_client: certificado .CER disponibilizado pelo Sicredi no internet banking;
• path_key_cliente: chave privada extraída do certificado digital (se foi seguido o passo a passo da documentação Pix Sicredi: gerando o certificado .CSR vai estar salvo no computador com o nome mkSicrediFinal.key).

 Testar comunicação

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

Image Modified

Este teste verifica se as chaves informadas na credencial estão certas e se os certificados tiveram o upload feito corretamente.