Como emitir PIX pela API do Sicoob

[Gines]

Olá desenvolvedor, nessa documentação iremos mostrar o passo a passo de como liberar as credenciais de integração do PIX junto ao Sicoob, e como correlacionar essas credenciais na API PIX da Tecnospeed.

Como solicitar os dados necessários?

Para começar a utilizar o registro instantâneo do Sicoob é necessário obter a credencial (client_id) associado a um certificado digital válido do tipo A1 (emitido pela ICP BRASIL). Abaixo estão listadas as etapas:

1º) Faça login no Portal Developers (https://developers.sicoob.com.br).

 

2º) É necessário cadastrar uma aplicação para a geração da credencial, para isso clique em “Nova Aplicação”.

3º) Nesse momento o Portal irá validar seus dados a partir de uma autenticação, para isso efetue o login com suas credenciais do SicoobNet.

4º) Em seguida clique em “Aprovar” para autorizar a validação dos seus dados.

5º)Pronto, agora você pode seguir com o cadastro do seu aplicativo. Para isso informe: Nome, Descrição e clicar em “Próximo”.

6º) Selecione "PIX" e clique em “Próximo”.

7º) Em seguida selecione o Número da Conta para a qual a credencial está sendo gerada.

8º) Nesse item "A integração será por uma empresa parceira?" você deve selecionar a opção "não".

9º) Selecione um certificado digital A1 válido que tenha sido emitido para o CNPJ do cedente, em seguida clique em “Próximo”. O certificado deve estar no formato .PEM para vincular o certificado à sua credencial.

Caso não saiba como exportar o .PEM verifique esta documentação: Certificado digital.

10º) Agora confirme os dados informados e caso esteja tudo ok e clique em “Concluir” e em seguida as credenciais estarão geradas para você! 

 

Observação: O Sicoob disponibilizou um vídeo tutorial reproduzindo esses passos, para visualizar clique aqui.

 

Como configurar as credenciais na API PIX?

Após obter os dados necessários, (client_id) e o certificado digital A1 vinculado à estas, tais dados deverão ser cadastrados no API PIX.

1) Cadastro da conta: 

- Rota: link direto para a documentação.

JSON de exemplo do cadastro das credenciais na API PIX: 

{
    "bankCode": "999",
    "bankAccount": "0001",
    "clientId": "f123a1b1-4e94-422b-aeb2-8fb6ed739648",
    "clientSecret": "32c16db0-5591-4231-915e-4244b81b593f",
    "clientKey": "4a1baab4-42b9-4107-b2b1-3ea425253f26",
    "pixKey": "1234567890"
}

2) Cadastro do certificado

- Rota: link direto para a documentação.

Exemplo do cadastro do certificado na API PIX: 

Collection em SandBox API PIX - Clique aqui!

Exemplo de resposta de cadastro de certificado: 
 

{
    "id": "4a1baab4-42b9-4107-b2b1-3ea425253f26",
    "surrogateKey": "2f1231b1-4e94-422b-aeb2-8fb6ed739648",
    "commonName": "CN=CERTIFICADO TESTE:01001001000101, OU=CERTTESTE, O=ICP-Brasil, C=BR, S=SP, L=Sao Paulo, E=, SE=3b f7 6e 4e 37 65 e4 23",
    "expirationDate": "2023-06-01T00:00:00.000Z",
    "hash": "a23b02dee71dd1e46d923452cd2bbb59a5c911e9",
    "serialNumber": "1bf42e4e3425e123",
    "description": "Certificado PIX",
    "extension": "pfx",
    "synchronized": false,
    "accountId": "accountId",
    "createdAt": "2023-06-01T00:00:00.000Z",
    "updatedAt": "2023-06-01T00:00:00.000Z",
    "deletedAt": null
}

Observações: Caso o processo tenha sofrido alterações, seguem alguns links diretos para a documentação do banco onde podem consultar na íntegra o processo: 

- Primeiros passos;
- Criar aplicativo em produção;

 

Open-Banking-Sicoob-–-Manual-para-Credenciais-API.pdf