Integração Sicredi
A integração com o Sicredi liga a conta PJ da sua empresa ao sistema para cobrar por PIX. O dinheiro cai direto na conta, pela tarifa combinada com a sua cooperativa.
O que a integração faz
Seção intitulada “O que a integração faz”- PIX. Gera a cobrança com QR Code e copia e cola, na chave PIX da conta do Sicredi.
- Validade da cobrança. O QR Code vale até o vencimento da transação. Sem vencimento, vale 1 hora.
- Baixa automática. O sistema dá baixa no pedido quando o pagamento aparece no Sicredi.
- Cancelamento. Cancelar a transação no sistema remove a cobrança PIX no Sicredi, e ela deixa de aceitar pagamento.
A integração não processa cartão. Para cartão, use um gateway (veja Integrações de Pagamento).
Como a liberação funciona no Sicredi
Seção intitulada “Como a liberação funciona no Sicredi”No Sicredi, a credencial do PIX (Client ID e Client Secret) sai de um certificado digital emitido para a conta da empresa. O Sicredi tem dois caminhos:
- Provedor parceiro do Sicredi: a empresa escolhe o provedor no Internet Banking e gera a credencial lá.
- Integração individual: o certificado e a credencial são gerados no Portal do Desenvolvedor do Sicredi.
No sistema, a ativação é pela integração individual: a sua empresa faz a adesão na cooperativa e envia os dados ao suporte, que cuida da parte técnica no Portal do Desenvolvedor. Se a empresa tiver um técnico próprio, ele também pode fazer essa parte, seguindo o Passo 3.
O que você precisa antes de começar
Seção intitulada “O que você precisa antes de começar”| Item | Onde conseguir |
|---|---|
| Adesão à API Pix aprovada, com o termo assinado | Gerente da sua cooperativa Sicredi |
| ID de adesão | E-mail de boas-vindas que o Sicredi envia depois da adesão |
| Cooperativa (4 dígitos, também chamada de agência) e Conta com o dígito | Internet Banking ou aplicativo do Sicredi |
| E-mail da empresa cadastrado na cooperativa | Gerente da sua cooperativa |
| Chave PIX só para o sistema | Internet Banking ou aplicativo do Sicredi |
A chave PIX precisa ser exclusiva do sistema: o motivo está em Regras e limites.
Passo 1: pedir a adesão na cooperativa
Seção intitulada “Passo 1: pedir a adesão na cooperativa”Esta parte só a sua empresa pode fazer.
- Procure o gerente da sua cooperativa e peça a adesão à API Pix para recebimento. Informe que é uma integração individual, com o sistema que você usa, e não por um provedor da lista do Sicredi.
- A cooperativa analisa o pedido e envia o termo de adesão para assinar.
- Depois da assinatura, o Sicredi envia um e-mail de boas-vindas com o ID de adesão. Guarde esse e-mail.
Passo 2: enviar os dados ao suporte
Seção intitulada “Passo 2: enviar os dados ao suporte”Envie ao suporte:
- o ID de adesão;
- o CNPJ da empresa titular da conta;
- a Cooperativa e a Conta com o dígito;
- o e-mail da empresa cadastrado na cooperativa.
Com esses dados, o suporte faz o Passo 3 e acompanha com você a conexão no sistema.
Passo 3: gerar o certificado e a credencial no Portal do Desenvolvedor
Seção intitulada “Passo 3: gerar o certificado e a credencial no Portal do Desenvolvedor”Esta etapa é feita no Portal do Desenvolvedor do Sicredi, com uma conta de desenvolvedor, pelo suporte ou pelo técnico da sua empresa.
- Na primeira integração da conta de desenvolvedor, abra um chamado em Suporte > Abra um chamado, do tipo Acesso à API Pix, com o CNPJ da empresa e o ID de adesão. O Sicredi responde em até 2 horas úteis, por e-mail. Segundo o Sicredi, nas integrações seguintes o acesso já fica liberado. Se o portal recusar a conta de outra empresa, abra o chamado de novo com o CNPJ e o ID de adesão dela.
- Abra a tela Certificados digitais das suas contas, informe a Cooperativa e a Conta e clique em Registrar novo CSR.
- Preencha o formulário:
| Campo | O que informar |
|---|---|
| CPF/CNPJ do associado | CNPJ da empresa titular da conta |
| CPF/CNPJ do parceiro | CNPJ de quem faz a integração |
| Cooperativa e Conta | Os números da conta, com o dígito da conta e sem traço |
| Nome do arquivo | Um nome que identifique a empresa, sem espaço nem acento. Exemplo: Requisicao_Pix_Mercado_Exemplo |
| Nome comum | O nome do certificado, sem espaço nem acento. O portal acrescenta “api-pix-” na frente. Exemplo: API_PIX_Mercado_Exemplo |
| E-mail do associado | E-mail da empresa cadastrado na cooperativa |
| Frase de segurança | Senha de no mínimo 8 caracteres que protege a chave privada. O portal não guarda a frase: anote |
- Clique em Registrar novo CSR. Logo em seguida o portal oferece o download do CSR, da chave privada e da chave privada sem senha. Baixe a chave privada sem senha: é ela que vai para o sistema.
- Acompanhe a lista de certificados da conta, na mesma tela (informe a Cooperativa e a Conta e clique em Buscar). O pedido aparece com a situação EM_PROCESSAMENTO enquanto o Sicredi valida, o que pode levar alguns dias úteis. Quando surgir a linha do tipo CERTIFICADO_VALIDADO com a situação OK, o certificado está pronto.
- No menu ⋮ do certificado validado, baixe o certificado (formato CER/PEM) e gere a credencial de produção. O portal mostra o Client ID e o Client Secret do PIX dessa conta. Não use o Client ID e o Client Secret de Minhas Apps: eles são de outras APIs do Sicredi e o PIX recusa.
Ao final, ficam prontos quatro itens: Client ID, Client Secret, o arquivo do certificado (.cer) e o arquivo da chave privada sem senha (.key). Os dois arquivos vão direto para o sistema, sem conversão. O Client Secret e a chave privada dão acesso às cobranças PIX da conta: guarde como uma senha e não compartilhe.
Passo 4: conectar no sistema
Seção intitulada “Passo 4: conectar no sistema”- No menu lateral, clique em Sistema e em Integrações.
- Busque por “Sicredi” e clique em Conectar.
- Preencha a janela:
| Campo | O que informar |
|---|---|
| Nome da conexão | Como a conta aparece nas telas do sistema |
| Client ID e Client Secret | A credencial gerada sobre o certificado validado, no menu ⋮ dele (não a de Minhas Apps) |
| 1. Certificado (.crt ou .cer) | O arquivo do certificado validado, com o CNPJ no nome (exemplo: 12345678000199.cer) |
| 2. Chave privada (.key) | A chave privada sem senha: o arquivo que termina em -sem-senha.key. A chave com senha não funciona |
| Ambiente de Conexão | Produção |
Quem já tem o arquivo .pfx, com o certificado e a chave juntos, pode enviá-lo no campo do certificado no lugar dos dois arquivos. Com o .pfx escolhido, o campo da chave privada some e aparece a Senha do Certificado: informe a senha do .pfx.
- Clique em Conectar e testar conexão. O sistema pede um acesso ao Sicredi com a credencial e o certificado: se algo estiver errado, a mensagem do Sicredi aparece na tela.
Passo 5: ligar à forma de pagamento
Seção intitulada “Passo 5: ligar à forma de pagamento”Conectar não basta: a forma de pagamento PIX precisa apontar para a integração.
- Clique em Vendas, depois em Pagamentos e em Formas de Pagamento.
- Abra (ou crie) a forma do tipo PIX e vá para a aba Pagamento Online.
- No campo Integração, escolha a conexão do Sicredi.
- Preencha a Chave PIX da conta do Sicredi, a exclusiva do sistema. O campo é obrigatório: sem a chave, a forma de pagamento não salva.
- Ative Disponível no checkout online e salve.
O passo a passo completo da tela está em Integrações de Pagamento.
Como a baixa acontece
Seção intitulada “Como a baixa acontece”A baixa é automática: o sistema acompanha a cobrança no Sicredi até ela ser paga ou expirar.
Para não esperar, abra Vendas > Pagamentos > Transações, selecione a transação e clique em Sincronizar: o sistema consulta o Sicredi na hora.
Regras e limites
Seção intitulada “Regras e limites”- Chave PIX exclusiva: use uma chave PIX só para o sistema. Com a mesma chave em outro sistema, um dos dois pode deixar de receber a confirmação dos pagamentos.
- Validade do certificado: o certificado do Sicredi tem data de vencimento, que aparece na lista do Portal do Desenvolvedor e na conexão, em Válido até. Antes de vencer, gere um certificado novo pelo Passo 3 e envie os arquivos novos na conexão. Certificado vencido faz as cobranças pararem.
- Tarifa: o PIX recebido pela integração paga a tarifa combinada com a sua cooperativa.
- Ambiente de testes: a credencial de testes do Sicredi não sai pelo Portal do Desenvolvedor. Para pedir, abra um chamado em Suporte > Abra um chamado > Suporte Técnico API Pix, com o motivo Cadastro Ambiente Homologação API PIX e o CNPJ da empresa.
Problemas comuns
Seção intitulada “Problemas comuns”O teste da conexão falha com “Authorization ou certificado inválido”: o Client ID e o Client Secret informados não são os gerados sobre o certificado. O erro mais comum é usar a credencial de Minhas Apps do Portal do Desenvolvedor. Gere a credencial no menu ⋮ do certificado validado e informe essa.
O teste da conexão falha com erro de certificado ou “Privilégios insuficientes”: o certificado e a chave privada não são do mesmo pedido, a chave enviada é a com senha, ou a credencial foi gerada sobre outro certificado. Envie o certificado validado e a chave privada sem senha do mesmo pedido, com a credencial gerada sobre esse certificado.
O pedido de certificado continua em EM_PROCESSAMENTO: a validação é feita pelo Sicredi. Se passar de alguns dias úteis, abra um chamado em Suporte Técnico API Pix no Portal do Desenvolvedor.
O PIX não gera e o checkout mostra “Ocorreu um erro interno”: a forma de pagamento PIX está sem a Chave PIX. Abra a forma, preencha a chave na aba Pagamento Online e salve.
O cliente pagou e o pedido continua em aberto: use Sincronizar na transação.
As cobranças pararam de funcionar de uma hora para outra: o certificado venceu. Gere um novo pelo Passo 3 e envie os arquivos na conexão.
Veja também
Seção intitulada “Veja também”- Hub de Integrações: conectar, pausar e excluir uma conexão
- Integrações de Pagamento: como escolher banco ou gateway
- Transações: acompanhar e sincronizar as cobranças