Termos mais procurados:
<@!243069612877414405> também tinha essa dúvida até o momento em que descobri que existem dois endpoints para o webhook do pix: "/xyz/pix" que é usado pra recepção do webhook, e outro "/xyz" para configuração do webhook, sendo "xyz" qualquer nome desejável.
Sim, pq aí ao invés de chamar /webhook/pix, vai chamar /webhook?ignorar=/pix . E aí isso vira parâmetro, não é mais parte do path.
Pode ser o nome do script tratando o webhook. Ou você pode ignorar o /pix colocando a URL como /webhook/?ignorar=
Boa noite <@!337383375289712651>. "webhook inválido" é uma resposta esperada dentro da nossa API, como a url respondeu com um código diferente de 200, quer dizer que algum requisito de cadastro do webhook ela não está cumprindo. Verifique na nossa documentação se você está seguindo os passos corretamente: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-configurar-o-webhook-pix
Sugerimos também que verifique a sessão de validação mTLS que é uma etapa importante do cadastro do webhook: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-entendendo-o-padr-o-mtls
Das rotas, você precisa tanto do webhook/ quanto do webhook/pix. O webhook/ é o que é testado pela GN na ativação, e o webhook/pix é o que é chamado na notificação de quitação.
a primeira e rapida
ao realizar a requisição PUT no /webhook:chave, a resposta que o gerencianet trará é útil? precisarei utilizar o conteudo dele pra alguma coisa ? poderia simplesmente dispensar ?
===segundo:===
num sistema, eu só teria que cadastrar o webhook apenas uma vez ? E se eu enviasse a requisição novamente, o webhook seria "sobescrito" ? Teria algum problema de sobrecarga na API de vocês? teria a possibilidade do meu servidor ser bloqueado?
=== terceiro: ===
Nas configurações do servidor para aceitar o webhook, como está no site (https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks)
meu sistema (feito em PHP) NÃO está utilizando o esquema de rotas
na seção:
// invés da rota /webhook, eu colocaria o caminho para o diretório simplesmente? (ex: {documentRoot}/.../.../webhook/)
SSLVerifyClient require
SSLVerifyDepth 3
na seção ALIAS seria basicamente a mesma coisa ?
Alias "/webhook/pix/" "/var/www/webhook/index.php" // Seria: {documentRoot}/../../webhook/pix/index.php (?) ou eu descartaria essa seção ?
Alias "/webhook/pix" "/var/www/webhook/index.php"
Você pode receber notificações automaticamente via webhook referente às modificações de status de uma cobrança Pix. Para isso, será necessário a inserção de uma chave pública da Gerencianet em seu servidor para que a comunicação obedeça o padrão mTLS.
Veja mais detalhes em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-webhooks
Ou seja, 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 um exemplo desta configuração em um servidor Apache ou Nginx: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor
Então com seu servidor configurado com mTLS em seu domínio (ex: https://seudominio.com.br/webhook/" class="link-msg">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.
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.
Veja mais detalhes sobre o endpoint: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-configurar-o-webhook-pix
Com isto, todo Pix gerado com sua chave Pix e que possua um txid, serão enviados as notificações para sua URL.
No envio de Pix, você precisa passar uma chave Pix para que o webhook seja usado para notificar se o envio de Pix deu certo ou não. Minha sugestão para facilitar conciliação posterior é criar uma chave aleatória só para envio, cujo único objetivo é ter um cadastro de webhook possivelmente diferente do de recebimento.
O usuário no caso seria o gn-webhook-pix (Gerencianet).
Essa falha é referente a tentativa de cadastro em seu webhook, onde não foi possível verificar o certificado (CA). Sugiro você verificar a documentação do mTLS e os exemplos disponíveis (https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-entendendo-o-padr-o-mtls).
Configurar pelo NGINX mesmo. O NGINX é um servidor HTTPS muito sólido. E aí só chega no PHP se tiver passado na checagem de mTLS do NGINX, então nem precisa duplicar a checagem. A única coisa interessante de checar no webhook PHP é se a chave Pix é sua mesmo, por causa da possibilidade de uso indevido do seu webhook por outro usuário na GN (que o mTLS em si não mitiga, mas conferir a chave, sim)
Não, mas você pode gerar um QR-Code estático com txid. Isso também vai permitir notificação no webhook e pesquisa no /pix. Mas a GN não vai checar o valor, então você precisa decidir a regra de negócio de se o cliente depositar um valor fora da faixa que você esperaria.
Bom dia <@!259869424012492800> , tudo bem ? Não é possível identificar o pagador na chamada, você vai precisar associar o txid (que é único) ao seu cliente. Segue o link da nossa documentação com os dados que são retornados no webhook:https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-recebendo-callbacks
Quando você fez a ativação, deu tudo certo ? GET /webhook mostra ele ativo para a chave Pix da cobrança teste ?
Outra forma de visualizar os Pix recebidos se você não for utilizar o webhook é pelo GET v2/pix, esta rota retorna apenas Pix recebidos facilitando a sua verificação. Você pode informar como parâmetro um período que deseja verificar se teve recebimento ou não.
É tipo assim, o que eu preciso é verificar se um pix foi pago pra enviar um item pro usuário.
Só que sem o webhook, ou eu faço uma rota pra ver se o cara pagou aquele pix, ou eu faço um cronjob que daqui 5 minutos vai chamar e enviar o item pro sujeito.
Compreendo, Pedro.
O mais próximo que temos que pode lhe ajudar, é uma configuração do webhook utilizando nodeJS e express
https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor
pessoal, como que eu coinsigo testar o webhook em homologação? A parte de pagamento de pix
Olá bom dia, estou tentando configurar o um webhook do PIX, porem utilizo um serviço "sem servidor" (serverless) da Amazon Lambda, ta sendo um tanto quanto complicado configurar um Hand-Shake
Entendi, é a última dúvida, se eu gerar um qrcode estatico para minha conta na GN, o webhook vai notificar quabdo receber o Pix?
