Histórico de mensagens sobre webhook pix

Ou dando um GET /v2/webhook/:chave serve para recuperação de informações sobre o webhook pix.

Para que você seja notificado acerca de Pix recebidos, etc, você deve configurar sue webhook vinculado à sua chave.
Para isso você consome a rota PUT /v2​/webhook/:chave, onde chave é sua chave Pix, e passando no body seu webhook:
{
"webhookUrl": "https://exemplo-pix/webhook"
}


Obs: Somente PIX associados a um txid serão notificados. Ou seja, cobranças geradas (atualmente com QrCode dinâmico) com sua chave Pix que possuírem um txid, você será notificado a cada alteração em seu webhook

Bom dia, estou desenvolvendo a integração com o webhook da api pix, seguindo a documentação fiz a configuração do NGINX com o certificado de desenvolvimento, entretanto ao configurar o webhook pela api, está retornando o seguinte erro:

aah certo, então se eu recebi esse webhook é pq o pix vou enviado com sucesso correto?

<@!671762828046106646> um webhook do PIX pode vir sem o parâmetro status ?? Reformulando: como no exemplo 2 da documentação? Qual seria a diferença de quando vem o status (exemplo 1) e sem status (exemplo 2)?

Pessoal o webhook do PIX é igual do cartão de crédito que fica enviando notificações constantemente ou apenas quando há alguma transação ou alteração no status de alguma cobrança?

Ativei os logs, mas não chegou nada. Tem alguma "janela" pra disparo desses webhooks ou é instantâneo (qdo chega/envia pix)?

O webhook é "trigado" qto tempo depois do recebimento do pix?

<@!704694550631022592> Para que você seja notificado acerca de Pix recebidos, etc, você deve configurar sue webhook vinculado à sua chave.
Para isso você consome a rota PUT /v2​/webhook/:chave, onde chave é sua chave Pix, e passando no body seu webhook:

Pessoal, uma dúvida: os webhooks são "acionados" apenas para PIX recebidos para determinada chave ou tbm é usado para "acompanhamento" de status de PIX enviado?

Pra quem tem dificuldades de implementar os webhooks por falta de suporte em hospedagem compartilhada para configurar mTLS, o Pix.ae agora oferece proxy de callbacks com mTLS.

Pra usar é muito simples: é só prefixar o seu domínio com mtls.pix.ae/. Por exemplo:

Para: https://exemplo.com.br/webhookpix
Use: https://mtls.pix.ae/exemplo.com.br/webhookpix

Obs: no ambiente de homologação, prefixe com mtls-h.pix.ae/

Na verdade, .webhook.pix.ae. Precisa do servername para decidir qual certificado apresentar.

webhook.pix.ae

:443>
ServerName idelivery.autum.com.br
ServerAlias .idelivery.autum.com.br
DocumentRoot /var/www/autum-idelivery/public

Options Indexes FollowSymLinks MultiViews
AllowOverride All
Order allow,deny
allow from all
Require all granted


SSLEngine on
#SSLCertificateFile "/etc/apache2/ssl/certificates/idelivery.autum.com.br.crt"
SSLCertificateFile "/etc/letsencrypt/live/idelivery.autum.com.br/fullchain.pem"
#SSLCertificateKeyFile "/etc/apache2/ssl/certificates/idelivery.autum.com.br.key"
SSLCertificateKeyFile "/etc/letsencrypt/live/idelivery.autum.com.br/privkey.pem"
SSLCACertificateFile "/etc/apache2/ssl/certificates/chain-pix-gerencianet-prod.crt"
SSLVerifyClient none


#SSLCACertificateFile "/etc/apache2/ssl/certificates/chain-pix-gerencianet-prod.crt"
SSLVerifyClient require
SSLVerifyDepth 3


ErrorLog ${APACHE_LOG_DIR}/autum-idelivery-error.log
CustomLog ${APACHE_LOG_DIR}/autum-idelivery-access.log combined

1- Ao criar uma cobrança, você pode consultar o pagamento pelo endpoint /v2/cob/:txid e verificar se a mesma está com o status CONCLUIDA. Outra alternativa é o webhook para notificarmos o seu sistema de forma automática sempre que ocorrer um pagamento ou devolução de Pix.

2- Cada cobrança(dinâmica) tem obrigatoriamente um txid associada a ela e um E2EID que é retornado quando transita na PACS002, PACS004 e PACS008. Então sim, cada Pix é diferente e tem seu identificador próprio.

3- No momento não tem como "forçar" pagamentos em ambiente de homologação, mas já está em nosso backlog essa funcionalidade.

Certo, solicitei ontem a chave, mas então assim: crio o token. Depois crio a cobrança (onde me retorna o@pix para o@user) depois configuro o webhook para avisar quando pagou, correto? Agora as dúvidas são o seguinte: 1- ao criar a cobrança onde informo um token meu para eu saber quando pagou (qual parâmetro) ? 2- cada pix é diferente para cada pedido?

<@!704694550631022592> Bom dia!
Não se preocupe, este canal é mesmo para tirar suas dúvidas! 😉
Primeiramente, para quaisquer consumo dos endpoints do Pix, é necessário realizar uma autenticação com suas credenciais client_id, client_secret e certificado. Para isso, seu primeiro consumo será na rota POST /oauth/token. Segue exemplos em algumas linguagens: https://dev.gerencianet.com.br/docs/api-pix#section-exemplos-de-autentica-o-utilizando-o-certificado-p12

Após a autenticação, você utilizará o endpoint para criar uma cobrança PUT /v2/cob/{txid}. Documentação: https://dev.gerencianet.com.br/docs/api-pix#section-criar-cobran-a-

Para acompanhar as mudanças de status de um pix, você pode configurar um webhook, que reúne endpoints para gerenciamento destas notificações. https://dev.gerencianet.com.br/docs/api-pix#section-webhook

Utilize também nossa Collection da Gerencianet com todos os endpoints já configurados para o consumo (https://dev.gerencianet.com.br/docs#section-collection-postman-gerencianet-api-pix).
A respeito do seu certificado, logo lhe retornaremos através do ticket.

{
"webhookUrl": "https://pixblack.in"
}

Boa tarde @everyone, sobre à adequação do /pix no webhook, ficou definido que será feito o cadastro do webhook base pelo integrador e a adição do parâmetro /pix no POST {$request.body#/webhookUrl} pela Gerencianet no momento do disparo das requisições.
Abaixo trazemos alguns exemplos de webhook e como será a notificação:

Integrador cadastrou a url base https://gerencianet.com.br/, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix.
Integrador cadastrou a url base https://gerencianet.com.br/pix, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix/pix.
Integrador cadastrou a url base https://gerencianet.com.br/?id=0000x22, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/?id=0000x22/pix.

Seguindo então a nossa documentação o serviço será POST {$request.body#/webhookUrl}/pix.

Tal definição foi feita após analisar os feedbacks de integradores, questionamentos ao BACEN e discussões internas.
A data para deploy do novo padrão está alinhada para o dia 01/02/2021. Sendo esta arbitrada a fim de que todos os integradores da API-Pix que utilizam o serviço de webhook possam ajustar seus sistemas e aplicações, e evitar assim falhas ou mal funcionamento do serviço.

Uma sugestão é permitir o recebimento da notificação em ambos os modos: com e sem /pix. Dessa forma, quando virarmos a chave, não haverá problemas.

À medida que se aproximar da data de deploy seremos mais assíduos nas notificações. Quaisquer dúvidas estamos a disposição em nossos canais de comunicação. [ATUALIZADO]

Boa tarde <@!798679248633856000> ! Consegue sim, o webhook é para automatizar o seu sistema, assim vamos notificar sempre que um Pix for recebido ou acontecer uma devolução. O <@!650023651512549427> falou tudo, estamos aqui para tirar dúvidas mesmo.