Notificações do Pix: integração com as APIs e mTLS

EXIBINDO RESPOSTAS:

Avatar discord do usuario juizmill

juizmill

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

Avatar discord do usuario rubenskuhl

rubenskuhl

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

Avatar discord do usuario guilherme_efi

guilherme_efi

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

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

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

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