Conectar Sicredi

⏱ Tempo estimado: 15-20 minutos

O Sicredi é uma das maiores cooperativas de crédito do Brasil. A API Pix usa autenticação OAuth2 com certificado mTLS (padrão Banco Central).

⚠️A API Pix do Sicredi está disponível apenas para associados PJ. Se você não tem conta PJ no Sicredi, escolha outro PSP.

Ter conta PJ no Sicredi

Você precisa ser associado PJ do Sicredi
Entre em contato com sua agência pra solicitar adesão à API Pix
Após aprovação, você receberá acesso ao Portal do Desenvolvedor

Cadastrar chave Pix

No app ou Internet Banking do Sicredi, cadastre uma chave Pix
A chave Pix será usada pra vincular as cobranças à sua conta
Copie e guarde a chave — você vai precisar dela no Hubpay

Acessar o Portal do Desenvolvedor

Acesse developer.sicredi.com.br
Faça login com suas credenciais do Sicredi
Crie uma nova aplicação
Selecione os escopos:
- cob.write (criar cobranças)
- cob.read (consultar cobranças)
- pix.read (consultar Pix recebidos)
- webhook.write (configurar webhooks)
- webhook.read (consultar webhooks)

Obter credenciais

No Portal do Desenvolvedor, copie o Client ID e Client Secret
Gere o certificado pra autenticação mTLS
Baixe o certificado (.crt) e a chave privada (.key)

⚠️O certificado é gerado pelo próprio Sicredi no portal. Não use certificados A1 — o Sicredi tem seu próprio formato. Siga as instruções do portal.

Conectar no Hubpay

Acesse hubpay.dev/dashboard/psps
Clique em Conectar novo PSP
Selecione Sicredi
Selecione o ambiente:
- Test = homologação
- Live = produção
Preencha:
- Client ID: do Portal do Desenvolvedor
- Client Secret: do Portal do Desenvolvedor
- Chave Pix: chave cadastrada na conta Sicredi
- Certificado: conteúdo do arquivo .crt
- Chave Privada: conteúdo do arquivo .key
Clique em Salvar credencial

💡🔒 Suas credenciais e certificado são criptografados com AES-256-GCM antes de serem armazenados.

Configurar webhook

Após salvar, siga as instruções na tela do dashboard pra configurar o webhook. O Sicredi segue o padrão Pix do BCB, enviando notificações de Pix recebidos vinculados à chave Pix configurada.

⚠️O Sicredi pode levar até 15 minutos pra confirmar o pagamento via webhook, conforme regulamentação do BACEN.

Testar

bash

curl -X POST https://api.hubpay.dev/v1/charges \
  -H "Authorization: Bearer hpx_test_SUA_CHAVE_HUBPAY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "provider": "sicredi",
    "description": "Teste Sicredi"
  }'

Solução de problemas

Erro	Causa	Solução
`502` com "SSL" ou "mTLS"	Certificado inválido	Confirme que colou o `.crt` e `.key` corretos, gerados no Portal do Desenvolvedor Sicredi.
`502` com "OAuth 401"	Client ID ou Secret incorretos	Verifique no Portal do Desenvolvedor.
`502` com "chave Pix"	Chave não cadastrada	Cadastre chave Pix no app/Internet Banking do Sicredi.
Certificado expirado	Certificados Sicredi expiram periodicamente	Gere novo no Portal do Desenvolvedor e atualize no Hubpay.
"Recurso não encontrado"	Endpoint incorreto ou ambiente errado	Confirme se está usando o ambiente correto (homologação vs produção).

Comparação com outros PSPs que usam mTLS

Aspecto	Efí	Banco Inter	Sicredi
Certificado	`.p12` → `.pem`	`.crt` + `.key`	`.crt` + `.key`
OAuth URL	`/oauth/token`	`/oauth/v2/token`	`/oauth/token`
OAuth body	JSON	x-www-form-urlencoded	x-www-form-urlencoded
API Pix	Padrão BCB `/v2/cob`	Padrão BCB `/v2/cob`	Padrão BCB `/v2/cob`
Conta	PF e PJ	Somente PJ	Somente PJ (associados)
Portal dev	dev.efipay.com.br	developers.inter.co	developer.sicredi.com.br