Histórico de mensagens sobre webhook em pix

EXIBINDO CONVERSAS RECENTES:

Texto: webhook
Canal: pix
Avatar discord do usuario jposouza

jposouza

Ver Respostas

Opa... isso mesmo. criei um subdomínio específico para os webhooks pra exigir o SSL

Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

Uma alternativa é criar um virtual host específico para o webhook, como webhook.exemplo.com.br, ao invés de exemplo.com.br/webhook. Vai precisar de certificado TLS também para esse virtual host, mas resolve também.

Avatar discord do usuario ivanovalmeida

ivanovalmeida

Ver Respostas

Tava brigando para achar como fazer no IIS, valeu... Amanhã já tento seguindo o vídeo rsrs.
Só uma duvida, tu criou uma outra aplicação para o webhook certo? Vi em alguns posts que o IIS não tem configuração para definir o mTLS somente para endpoints específicos.

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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.

Avatar discord do usuario didio4130

didio4130

Ver Respostas

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?

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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.

Avatar discord do usuario didio4130

didio4130

Ver Respostas

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?

Avatar discord do usuario sergiomsa

sergiomsa

Ver Respostas

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?

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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.

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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

Avatar discord do usuario sergiomsa

sergiomsa

Ver Respostas

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

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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.

Avatar discord do usuario sergiomsa

sergiomsa

Ver Respostas

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?

Avatar discord do usuario joelemanoel

joelemanoel

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

Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

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

Ver Respostas

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

Ver Respostas

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 brunodelara

brunodelara

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