Author Image

juizmill

Apr 1, 2021

Recebimento de Notificações do PIX via GerenciaNet

notificações do PIXAPI de cobrançasmTLSGerencianetendpointreceber notificaçõesservidor dedicadochave públicatxidwebhookUrl

boa tarde
para receber notificações do PIX é através destes endpoint?

estou querendo receber notificação no meu sistema quando chegar um PIX na minha conta GerenciaNet
esta possibilidade existe certo?
imagem enviada na mensagem pelo usuario juizmill

Respostas (5):
Avatar discord do usuario rubenskuhl

rubenskuhl

01/04/2021

Existe para Pix que tenham txid. Demais, apenas via polling.

Avatar discord do usuario guilherme_efi

guilherme_efi

01/04/2021

Boa tarde, <@!257617133595262977>. As notificações do Pix funcionam um pouco diferentes da API de cobranças.
Primeiramente, para um servidor dedicado, você deve inserir uma chave pública da Gerencianet em seu servidor para que a comunicação obedeça o padrão mTLS.

Então com seu servidor configurado com mTLS em seu domínio, ex https://seudominio.com.br/webhook, você irá consumir a rota PUT /v2​/webhook/:chave uma única vez para registrar seu webhookUrl vinculado à sua chave Pix.

Com isto, todo Pix gerado com sua chave Pix e que possua um txid, serão enviados as notificações para sua URL.

Avatar discord do usuario juizmill

juizmill

01/04/2021

posso dar qualquer nome para a minha URL ou sou obrigado a por webhook logo após o meu domínio?

Avatar discord do usuario guilherme_efi

guilherme_efi

01/04/2021

Pode ser qualquer nome.
Acrescentando uma observação que é a adição do /pix no final da sua URL. Ou seja, na request PUT https://api-pix.gerencianet.com.br/v2/webhook/:chave você irá passar o body com sua URL, exemplo:

json
{
"webhookUrl": "https://seudominio.com.br/webhook"
}
No entanto, a URL será registrada com o /pix no final, assim: https://seudominio.com.br/webhook/pix. Então esta adição do /pix também dever ser tratada nas configurações de seu servidor para que na rota /webhook/pix de seu servidor exija o certificado CA da Gerencianet.

Avatar discord do usuario juizmill

juizmill

01/04/2021

OK, mTLS é um certificado que geramos com a GerenciaNet com a extensão de nome .p12 ?

A Comunidade Efí no Discord reúne mais de 11382 desenvolvedores 👨‍💻 incríveis.

Participe para se manter atualizado sobre as APIs da Efí Pay, tirar dúvidas e muito mais! 😊

📰 Discussões relacionadas