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 (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.54 - 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 de adesão

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. O gerente vai direcionar para a equipe de onboarding Pix.

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

• Possui provedor para integração: Sim
• Se sim, qual? MK Solutions (software house já homologada)
• Nome do responsável pela integração: (informe o nome do responsável no provedor que vai realizar o contato com o Sicredi)
• E-mail: (informe o e-mail em que deseja receber a cartilha de integração)
• Telefone comercial: (número comercial do provedor)
• Finalidade: Gerar Cobrança Imediata - Cob

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.

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.

Execute no terminal:

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:

Informe a senha gerada nos passos anteriores:

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 no mk erp.

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 útei 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 Sicredi (gerada pelo Sicredi 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: 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 Sicredi 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). ATENÇÃO: a partir da release nº 64 do ERP esta certificado não é mais necessário! Por isso o campo para upload não ficará visível.
• 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 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:

Este teste verifica se as chaves informadas na credencial estão certas e se os certificados tiveram o upload feito corretamente. Como os certificados são obrigatórios para geração do PIX Sicredi observe que se não for realizado o upload o retorno do teste não será OK:

A API do Sicredi realiza as transações utilizando o certificado digital .CER que é gerado no internet banking. Este certificado é gerado com o padrão de 2 anos de validade. Na ferramenta Exibir dados do certificado é possível verificar o status:

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