Integração PIX com o banco SICREDI 🧐

[Pedro.Bravin]

Olá desenvolvedor!

Neste post iremos disponibilizar à você algumas informações sobre como realizar a integração PIX utilizando o banco SICREDI.

Quando vamos realizar a integração do banco SICREDI na api PIX, acabamos ficando muito confusos por conta de que é um processo extenso😩 .

Porém pode ficar tranquilo que nesta documentação, vamos te passar todo o passo a passo de como realizar este processo, de uma maneira simples e objetiva. Vamos lá?

 

Passo 1 - Gerar o arquivo de chave (.key)

Para fazer estes processos, certifique-se de ter o open ssl instalado.

Será necessário colocar no terminal exatamente os comandos conforme abaixo:

# openssl genrsa -des3 -out APLICACAO.key 2048

 

Recomendações:
•  Algoritmo da chave: RSA (genrsa);
•  Tamanho da chave: 2048 ou mais;
•  Criptografia da senha da chave privada: AES256 ou Triple DES (-aes256 ou -des3).

 

Passo 2- Será solicitado o preenchimento de uma senha:

Neste passo será solicitada uma frase secreta para gerar o arquivo de chaves, conforme abaixo:

 Enter pass phrase for APLICACAO.key:
 Verifying - Enter pass phrase for APLICACAO.key:

Informe um valor qualquer para a frase secreta, e anote-o para ser usado no passo 2.

 

Passo 3 - Gerar a requisição do certificado (.csr) através da chave (.key) gerada no passo anterior

# openssl req -new -key APLICACAO.key -out APLICACAO.csr

 

4- Será solicitada a senha que você cadastrou e preencher as informações (país, estado, cidade, etc) EXATAMENTE como está no manual:

Neste passo será solicitada a frase secreta cadastrada no passo 1, ao digitá-la as seguintes informações serão solicitadas, preencha conforme padrão Sicredi abaixo:

- Country Name (2 letter code) [AU]: BR

- State or Province Name (full name) [Some-State]: Rio Grande do Sul

- Locality Name (eg, city) [ ]: Porto Alegre

- Organization Name (eg, company) [Internet Widgits Pty Ltd]: Confederacao Interestadual das Cooperativas Ligadas ao Sicredi

- Organizational Unit Name (eg, section) [ ]: API PIX Sicredi

- Common Name (eg, YOUR name) [ ]: Utilizar o prefixo api-pix- + Nome do Estabelecimento,

 

5- Será solicitado o preenchimento do nome do seu estabelecimento junto do prefixo api-pix como abaixo:
 

Exemplo: api-pix-SUPERMERCADOABC

 

6- Após isso, será solicitado o preenchimento do seu e-mail: 
 

- Email Address [ ]: [E-mail do Associado]

 

7- Para finalizar a etapa de preenchimento, você irá deixar vazio e apenas apertar a tecla "enter" para o campo senha:
 

- A challenge password [ ]: Campo não setado

- An optional company name [ ]: Campo não setado

 

Passo 8 - Retirando a frase secreta

Dependendo do Web Server será necessário retirar a frase secreta da chave (.key) gerada no primeiro passo para que a mesma não seja solicitada no momento de algum restart do Web Server.

 

9- Feito isso, será necessário retirar a frase secreta da chave que foi gerada. Será retirada utilizando os comandos:

Para isso, execute os passos abaixo informando a senha definida no primeiro passo.

# mv APLICACAO.key APLICACAO_COMSENHA.key

# openssl rsa -in APLICACAO_COMSENHA.key -out APLICACAO.key

 

Integração do SICREDI na API PIX (Internet Banking):

 

Agora que você conseguiu todas estas credenciais do Sicredi, basta seguir as etapas abaixo:

 

ETAPA 1

     1.1 Acesse o Internet Banking com seus dados de Cooperativa e Conta

     1.2 Clique no menu Outros Serviços / Acesso API Pix / Gerenciar Certificados

     1.3 Realize o Upload do arquivo CSR (Certificate Signing Request)* *Está disponível ao inicio desta cartilha um anexo com instruções para geração do arquivo.

     1.4 Avance as etapas para concluir a solicitação

Observação:

• O arquivo enviado será recebido pelo Sicredi e avaliado dentro do perímetro de segurança dos mesmos.

• Com as informações validadas, dentro do prazo informado o banco disponibilizará seu certificado digital assinado, que é necessário para a correta implementação. Para isso, siga a próxima etapa.

ETAPA 2

     2.1 Acesse o Internet Banking com seus dados de Cooperativa e Conta

     2.2 Clique no menu Outros Serviços / Acesso API Pix / Gerenciar Certificados

     2.3 Realize o download dos arquivos disponibilizados - Certificado Digital .CER e Cadeia de Certificados Completa Sicredi .CER

Observação:

• Realizada esta etapa é possível gerar suas credenciais de acesso (Cliente_Id e Cliente_Secret). Para isso, siga a próxima etapa.

ETAPA 3

     3.1 Acesse o Internet Banking com seus dados de Cooperativa e Conta

     3.2 Clique no menu Outros Serviços / Acesso API Pix / Gerar Credenciais

     3.3 Selecione o Certificado Digital Aprovado

     3.4 Selecione o ambiente virtual de Homologação (obrigatório para a realização de testes e validações)

     3.5 Selecione o campo de ‘Aceite’ do Termo de Uso apresentado em tela

           Avance a etapa para prosseguir com a solicitação

     3.6 Digite os números correspondentes a sua assinatura eletrônica

           Avance a etapa para finalizar a solicitação

IMPORTANTE:

• É fundamental realizar todos os testes em URL de homologação indicados no Manual de Integrações API Pix Sicredi (página 14), para alcançarmos os casos de sucesso descritos.

• Somente ao final de todo o processo de homologação, é que a solicitação da geração das credenciais ao ambiente de Produção deve ser solicitada no Internet Banking. Para isso, siga a próxima etapa.

ETAPA 4

     4.1 Acesse o Internet Banking com seus dados de Cooperativa e Conta

     4.2 Clique no menu Outros Serviços / Acesso API Pix / Gerar Credenciais

     4.3 Selecione o Certificado Digital Aprovado

     4.4 Selecione o ambiente virtual de Produção

     4.5 Selecione o campo de ‘Aceite’ do Termo de Uso apresentado em tela

           Avance a etapa para prosseguir com a solicitação

     4.6 Digite os números correspondentes a sua assinatura eletrônica

           Avance a etapa para finalizar a solicitação

Observação:

• As credenciais geradas nas etapas 3 e 4 serão apresentadas em tela e poderão ser copiadas através dos botões “Copiar Client_ID” e “Copiar Client_Secret”.

• Atenção: Suas credenciais não poderão ser consultadas posteriormente, portanto recomendamos que já sejam armazenadas em local seguro.

 

Após a finalização de todas as etapas, basta então realizar o cadastro na conta na API, e também incluir o certificado digital. Esta tudo completo, pode emitir um pix para teste.

Viu como é fácil? Sim a documentação é extensa, porém seguindo este passo a passo, você conseguirá integrar o Sicredi com a API PIX. 

OBS: Todas as informações contidas neste Post, foram fornecidas diretamente pelo banco SICREDI conforme a documentação em anexo.

Caso tenha qualquer dúvida sobre o cenário explicado ou se quiser conhecer nossas soluções , estaremos sempre à disposição e será um prazer ajudar!

Cartilha_IB_V3.pdf

[Guilherme Borges]

Muito bom!

[wesleifelix]

Não sei se eu não soube ler o documento, mas não as URL para envio.

[edsonmartins]

@Pedro.Bravina chave .key e o certificado precisão ser gerado no servidor onde a aplicação ficará hospedada em produção ou pode ser gerada por exemplo, no meu computador?

[Thobias Silva]

Em 06/07/2022 at 09:22, Pedro.Bravin disse:

Manual de Integrações API Pix Sicredi (página 14)

Tens o link dessa documentação?

[makuxi]

Pra quem tiver interesse tem essa documentação do Banco Sicredi V2.3

Manual Técnico Integrações API Pix Sicredi V2.3 .pdf

[Lenio]

@Pedro.Bravin É possível também fazer pagamentos por PIX no SICREDI via API?