Pix por API – Obtenção de Credênciais Sicredi (748)
Introdução
Este guia detalha o processo completo de obtenção de Credenciais com o Banco Sicredi para geração de QR Code PIX no sistema Centrium Pag. Como complemento a documentação:
Baseado na cartilha oficial do Sicredi.
Pré-requisitos
Antes de iniciar, reunir:
- Conta e Cooperativa Sicredi
- Acesso ao Internet Banking empresarial
- Assinatura eletrônica habilitada
- OpenSSL instalado no servidor ou estação
- Chave Pix cadastrada
- Dados da empresa:
- Razão social
- E-mail responsável
- Nome do estabelecimento
Fluxo Geral
O processo possui 4 etapas:
- Gerar arquivos
.keye.csr - Enviar CSR no Internet Banking
- Baixar certificados aprovados
- Gerar credenciais de Homologação e Produção
Etapa 1 – Geração do CSR
Gerar chave privada (.key)
Executar:
openssl genrsa -des3 -out APLICACAO.key 2048
Recomendações do Sicredi:
- Algoritmo RSA
- Tamanho mínimo 2048 bits
- Utilizar criptografia AES256 ou Triple DES
Durante o processo será solicitada uma senha para a chave privada. Guardar esta senha.
Gerar arquivo CSR (.csr)
Executar:
openssl req -new -key APLICACAO.key -out APLICACAO.csr
Preencher os campos conforme padrão Sicredi:
| Campo | Valor |
|---|---|
| Country Name | BR |
| State | Rio Grande do Sul |
| City | Porto Alegre |
| Organization Name | Nome da empresa |
| Organizational Unit | API PIX Sicredi |
| Common Name | api-pix-NOMEEMPRESA |
| Email Address | E-mail do associado |
Campos opcionais podem permanecer vazios.
Remover senha da chave
Executar:
mv APLICACAO.key APLICACAO_COMSENHA.key
openssl rsa -in APLICACAO_COMSENHA.key -out APLICACAO.key
Etapa 2 – Upload do CSR no Internet Banking
Acessar:
Outros Serviços → Acesso API Pix → Gerenciar Certificados
Realizar upload do arquivo .csr que foi disponibilizado pela Centrium
Após análise do Sicredi, o certificado será disponibilizado para download.
Etapa 3 – Download dos Certificados
No Internet Banking:
Outros Serviços → Acesso API Pix → Gerenciar Certificados
Baixar:
- Certificado Digital
.CER - Cadeia Completa Sicredi
.CER
Etapa 4 – Geração das Credenciais
Homologação
Acessar:
Outros Serviços → Acesso API Pix → Gerar Credenciais
Selecionar:
- Certificado aprovado
- Ambiente Homologação
- Aceite do termo
Finalizar utilizando assinatura eletrônica.
Produção
Após validação completa em homologação:
Outros Serviços → Acesso API Pix → Gerar Credenciais
Selecionar:
- Certificado aprovado
- Ambiente Produção
- Aceite do termo
Finalizar utilizando assinatura eletrônica.
Credenciais Geradas
O Sicredi exibirá:
- Client_ID
- Client_Secret
⚠️ Atenção:
As credenciais não podem ser consultadas novamente posteriormente. Devem ser armazenadas imediatamente em local seguro.
Arquivos Necessários para Implantação
A empresa deverá enviar de volta para a Centrium:
| Arquivo |
|---|
| Certificado .CER |
| Cadeia Completa Sicredi .CER |
| Client_ID |
| Client_Secret |
Referência
Cartilha oficial Sicredi – Integração API Pix no Internet Banking.