Histórico de mensagens sobre webhook

Pode ser qualquer nome, /webhook é só um exemplo hehe
No então é necessário atentar-se sobre 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:
{
"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.

Olá <@!775350441965649951> , boa tarde!
Então eu preciso ter as rotas com esses nomes?
meudominio.com.br/webhook
meudominio.com.br/webhook/pix/
Não poderia ser qualquer nome de rota?

Olá,<@!818197250840199198>. Boa tarde!
Basicamente é isto mesmo, você irá configurar em seu servidor a rota POST para a rota /webhook por exemplo e para rota /webhoo/pix, com a adição do /pix, e configurar para que nestas rotas exija o certificado CA da Gerencianet. Então com estas validações, basta tratar para receber o conteúdo do body.

Olá Pessoal, boa tarde!
Estou implementando a cobrança Pix na minha aplicação e gostaria de fazer uso de Webhook para não precisar ficar consultando as cobranças de tempo em tempo. Nunca implementei Webhook e gostaria de saber se entendi o princípio.
Basicamente eu registraria uma rota de post na minha aplicação e quando um determinado evento acontecer eu receberia informações sobre ele no conteúdo do meu body?

Opa. Fiz todas as configurações do webhook no meu servidor e realizei um pagamento de PIX. Onde posso verificar o log de envio da notificação?

Para vincular/cadastrar sua URL para sua chave Pix, é realizada através do endpoint PUT /v2​/webhook/:chave. Exemplo: /examples/pix/webhooks/update.php da SDK de PHP.

Esta linha refere-se ao CA da Gerencianet/chave pública. Esta você obtêm no seguinte link, para produção: https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt

No exemplo de configuração no Nginx tem as linhas ssl_client_certificate /root/chain-pix-webhooks-prod.crt

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 (forma de autenticação mutua).
Veja mais detalhes em: https://dev.gerencianet.com.br/v1/docs/api-pix#section-webhook

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. Na SDK de PHP você pode utilizar do exemplo: /examples/pix/webhooks/update.php

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:
{
"webhookUrl": "https://seudominio.com.br/webhook"
}

No entanto, a URL será registrada com o /pix no final, assim: https://seudominio.com.br/webhook/pix.
Ou seja, 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.

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

Eu não sei a contra-parte no SDK, mas a função da API que você está buscando é esta aqui: https://dev.gerencianet.com.br/docs/api-pix#section-configurar-o-webhook-pix-

Estou tentando criar um webhook para receber as notificações de pagamento de uma transação PIX. Estou utilizando o SDK PHP para criar a transação PIX. Alguém poderia por gentileza direcionar o que tenho que fazer?

Ambiente de homologação é: https://pix.gerencianet.com.br/webhooks/chain-pix-sandbox.crt
Ambiente de produção é:
https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt

mTLS é a forma de autenticação mutua. O certificado é como você vai fazer essa autenticação. Mas você não irá utilizar este certificado não, deve usar a chain publica fornecida pega GN e disponível em: https://dev.gerencianet.com.br/v1/docs/api-pix#section-webhook

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:

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

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.

<@!671762828046106646> pode verificar os logs do webhook?

Tem que se atentar que as vezes o PSP pode não estar enviando as informações para que o webhook seja acionado, como o txid por exemplo.

Boa tarde <@!89083132287938560>, o funcionamento do webhook está normal, não tivemos reporte de mais nenhum integrador e inclusive fiz um teste agora com 3 PSPs diferentes e em todos foi notificado com sucesso.

Problema é intermitente. As vezes manda o Webhook, as vezes não