Pular para o conteúdo
Acessar sistema

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.

  • 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).

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.

ItemOnde conseguir
Adesão à API Pix aprovada, com o termo assinadoGerente da sua cooperativa Sicredi
ID de adesãoE-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ígitoInternet Banking ou aplicativo do Sicredi
E-mail da empresa cadastrado na cooperativaGerente da sua cooperativa
Chave PIX só para o sistemaInternet Banking ou aplicativo do Sicredi

A chave PIX precisa ser exclusiva do sistema: o motivo está em Regras e limites.

Esta parte só a sua empresa pode fazer.

  1. 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.
  2. A cooperativa analisa o pedido e envia o termo de adesão para assinar.
  3. Depois da assinatura, o Sicredi envia um e-mail de boas-vindas com o ID de adesão. Guarde esse e-mail.

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.

  1. 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.
  2. Abra a tela Certificados digitais das suas contas, informe a Cooperativa e a Conta e clique em Registrar novo CSR.
  3. Preencha o formulário:
CampoO que informar
CPF/CNPJ do associadoCNPJ da empresa titular da conta
CPF/CNPJ do parceiroCNPJ de quem faz a integração
Cooperativa e ContaOs números da conta, com o dígito da conta e sem traço
Nome do arquivoUm nome que identifique a empresa, sem espaço nem acento. Exemplo: Requisicao_Pix_Mercado_Exemplo
Nome comumO nome do certificado, sem espaço nem acento. O portal acrescenta “api-pix-” na frente. Exemplo: API_PIX_Mercado_Exemplo
E-mail do associadoE-mail da empresa cadastrado na cooperativa
Frase de segurançaSenha de no mínimo 8 caracteres que protege a chave privada. O portal não guarda a frase: anote
  1. 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.
  2. 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.
  3. 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.

  1. No menu lateral, clique em Sistema e em Integrações.
  2. Busque por “Sicredi” e clique em Conectar.
  3. Preencha a janela:
CampoO que informar
Nome da conexãoComo a conta aparece nas telas do sistema
Client ID e Client SecretA 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ãoProduçã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.

  1. 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.

Conectar não basta: a forma de pagamento PIX precisa apontar para a integração.

  1. Clique em Vendas, depois em Pagamentos e em Formas de Pagamento.
  2. Abra (ou crie) a forma do tipo PIX e vá para a aba Pagamento Online.
  3. No campo Integração, escolha a conexão do Sicredi.
  4. 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.
  5. Ative Disponível no checkout online e salve.

O passo a passo completo da tela está em Integrações de Pagamento.

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.

  • 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.

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.