Como emitir PIX pela API do Gerencianet

[leonardo.figueiredo]

Fala, desenvolvedor! Beleza? Nesse post, irei mostrar para você como obter as credenciais para emissão do PIX para a Gerencianet e realizar seu cadastro na API Pix da TecnoSpeed para já sair emitindo.

Essa documentação está dividida em duas partes: obtenção das credenciais no Gerencianet e registro na API PIX da TecnoSpeed. Para começar, é necessário que você tenha cumprido todos os requisitos apresentados abaixo.

Pré-requisitos:

• Conta ativa no banco Gerencianet;
• Acesso ao portal do banco (https://sistema.gerencianet.com.br/);
• Um contrato ativo com a API do PIX da Tecnospeed.

Vamos lá! Para solicitar as credenciais do banco e cadastrar na API da TecnoSpeed, é necessário que:

1) Acesse o portal do banco e entre na seção API

Essa seção é responsável pela administração das APIs disponibilizadas pelo Gerencianet.

 

2) Acesse Minhas Aplicações

No menu lateral direito, há a opção “Minhas Aplicações”. Nessa seção, iremos solicitar as permissões para o uso da API PIX do Gerencianet. 

 

3) Crie uma nova aplicação

Ao clicar em Nova Aplicação, uma tela será exibida para o cadastro da API no banco. Fique à vontade para dar nome à sua aplicação.

 

4) Selecione as permissões

Na parte inferior da tela de Nova Aplicação, é possível selecionar as permissões de acesso à API PIX do Gerencianet. Selecione as permissões conforme a imagem abaixo, pois são as operações realizadas dentro da API da TecnoSpeed.

 

5) Clique em Criar nova aplicação

Após dar nome à aplicação e selecionar as permissões, é hora de concluir o processo. Clique no botão “Criar nova aplicação”. Em seguida, será aberto um “pop-up” solicitando sua assinatura eletrônica. Após confirmação, podemos seguir para a próxima etapa.

6) Aviso de certificado ativo necessário

Ao confirmar o registro da API no sistema do banco, o sistema irá alertá-lo da necessidade de criação de um certificado digital. Não se preocupe, pois o certificado pode ser gerado dentro do próprio sistema do Gerencianet.

 

7) Obtenção do Client ID e Client Secret

Após clicar em “Continuar”, você será direcionado para a página contendo o Client ID e Client Secret da API PIX. São as credenciais solicitadas para a emissão da cobrança.

 

8) Cadastrar um certificado

Novamente, acesse o menu lateral. Nele, há a opção “Meus certificados”. Nessa tela, iremos solicitar o certificado digital que será usado na emissão. Clique em Novo Certificado, dê um nome ao certificado e confirme sua senha eletrônica.

 

9) Baixe o certificado

Clique em Baixar Certificado na tela que será exibida após a confirmação da senha eletrônica. Tome muito cuidado nesta etapa, pois o certificado só pode ser baixado uma vez. O certificado vem em formato .p12 e não é necessário convertê-lo para integrar com nossa API.

 

Pronto, agora só cadastrar o clientId, clientSecret e certificado na API PIX da TecnoSpeed!

 

10) Cadastro das credenciais na API PIX da TecnoSpeed

A documentação para cadastro das contas de emissão em nossa API encontra-se aqui. Para o cadastro, você deve estar com o clientId, clientSecret, e certificado em mãos, além de uma chave PIX gerada pelo aplicativo do banco. A requisição para a criação da conta ficará nesse formato:

{
    "bankCode": "364",
    "clientId": "client_id",
    "clientSecret": "client_secret",
    "pixKey": "chave_pix"
}

Feito isso, será retornado um identificador (id) da conta cadastrada. Agora, é necessário vincular um certificado digital à conta. A requisição com o certificado, documentada aqui, ficará da seguinte forma (usando o Insomnia como exemplo):

OBS: O certificado da Gerencianet não possui senha, sendo necessário informar uma string vazia no campo password.

 

11) Pronto, agora só começar a emitir!

Nossa documentação para a geração de PIX encontra-se neste link.

 

Bibliografia:

• Documentação da API PIX Gerencianet: https://dev.gerencianet.com.br/docs/api-pix-autenticacao-e-seguranca
• Documentação da API PIX TecnoSpeed: https://docs.pix.tecnospeed.com.br/