| Painel | ||||||
|---|---|---|---|---|---|---|
| ||||||
Índice
|
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
| Informações | ||
|---|---|---|
| ||
Atenção! Caso não tenha nenhuma profile do Sicredi 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 Sicredi 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. |
Informações sobre o mk erp que serão solicitadas pelo Sicredi (em destaque as respostas que devem ser enviadas):
...
E após execute:
| Informações |
|---|
pkcs8 -topk8 -inform PEM -outform PEM -in mkSicredi1.key -nocrypt -out mkSicrediFinal.key |
Pronto! O certificado foi gerado, ele fica salvo dentro da pasta OpenSSL-1.1.1h_win32
...
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:
| Informações | ||
|---|---|---|
| ||
O cadastro dos dados é de responsabilidade exclusiva do provedor! |
Preencha os seguintes campos:
- Chave PIX: chave Pix da conta Sicoob Sicredi (gerada pelo Sicoob 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 Sicoob 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 😊