Pode, mas falha muito pouco. Então daria para combinar webhook + polling de intervalo mais longo.
Termos mais procurados:
Histórico de mensagens sobre webhook
PROCURE NO HISTÓRICO
CANAIS DE TEXTO
DISCUSSÕES
- Conceito de Payload Locations no PIX
- Inserção automática do formato do Pix copia e cola pelo WhatsApp
- Autenticação com Certificado em NextJS
- Consulta de Chave PIX na API de Envio
- Configuração de URLs para Recebimento de Status
- Implementação da SDK do Pix em Next.js ou React
- Acionamento de Webhooks em Pagamentos e Devoluções
- Especificação da URL do Webhook no Exemplo Pix
- Implementação do Módulo Gerencianet no Perfex CRM
- Repetição do Processo de Criação com txid
- Cobrança em Período de Teste Grátis de 7 dias
- Recebimento de Pagamentos via QR Code e Arduino
- Teste de Status de Pagamento em Ambiente de Homologação
- Integrações com o Laravel e SDK de PHP da EFI
- Problemas com Token em Ambiente de Homologação
- Tempo Médio de Análise de Documentos na Abertura de Conta
- Resolução de Delay nas Chamadas de Geração de QR Code e Pix em Node
- Geração de Link de Pagamento e Reembolso
- Atualização de informações no Retentiva de Cobrança
- Funcionamento do Webhook em Ambiente de Homologação
- Retenção de Pagamento no PIX em Marketplace
- Notificações de Pagamento de Boleto e Pix
- Cancelamento de Boleto e Remoção do DDA
- Utilização de Endpoints e Payload no Pix
- Interpretação do Campo 'Solicitação ao Pagador' no Webhook GN
EXIBINDO CONVERSAS RECENTES:
Texto: webhook
e a notificação nunca chega, ai já viu.. teria que criar um mecanismo para resolver essa falha da estrutura do webhook
Tipo, o webhook pode falhar.
Então, detalhe mesmo do webhook é em relação a confiabilidade.
Se fosse o próprio POS sem servidor o melhor era polling... mas em tendo um servidor, pq não webhook ? Mesmo com estático dá para ter webhook, só colocar um txid no QR.
Webhook ou polling ?
Atualizem o guia de configuração nginx do hand-shake do pix,
nginx
server {
#
# ...
#
listen [::]:443 ssl ipv6only=on;
listen 443 ssl;
ssl_certificate server_ssl.crt.pem;
ssl_certificate_key server_ssl.key.pem;
ssl_client_certificate /root/chain-pix-webhooks-prod.crt;
ssl_verify_client optional;
ssl_verify_depth 3;
#
# ...
#
location /webhook {
if ($ssl_client_verify != SUCCESS) {
return 403;
}
proxy_pass /webhook;
}
}
#Desenvolvido pela Consultoria Técnica da Gerencianet
paraserver {
#
# ...
#
listen [::]:443 ssl ipv6only=on;
listen 443 ssl;
ssl_certificate server_ssl.crt.pem;
ssl_certificate_key server_ssl.key.pem;
ssl_client_certificate /root/chain-pix-webhooks-prod.crt;
ssl_verify_client optional;
ssl_verify_depth 3;
#
# ...
#
location /webhook {
if ($ssl_client_verify != SUCCESS) {
return 403;
}
proxy_pass /webhook;
}
}
#Desenvolvido pela Consultoria Técnica da Gerencianet
nginx
server {
#
# ...
#
listen [::]:443 ssl ipv6only=on;
listen 443 ssl;
ssl_certificate server_ssl.crt.pem;
ssl_certificate_key server_ssl.key.pem;
ssl_client_certificate /root/chain-pix-webhooks-prod.crt;
ssl_verify_client optional;
ssl_verify_depth 3;
#
# ...
#
location /webhook {
if ($ssl_client_verify != SUCCESS) {
return 403;
}
proxy_pass https://IP_DA_APLICAÇÃO:7080/webhook;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
#Desenvolvido pela Consultoria Técnica da Gerencianet
server {
#
# ...
#
listen [::]:443 ssl ipv6only=on;
listen 443 ssl;
ssl_certificate server_ssl.crt.pem;
ssl_certificate_key server_ssl.key.pem;
ssl_client_certificate /root/chain-pix-webhooks-prod.crt;
ssl_verify_client optional;
ssl_verify_depth 3;
#
# ...
#
location /webhook {
if ($ssl_client_verify != SUCCESS) {
return 403;
}
proxy_pass https://IP_DA_APLICAÇÃO:7080/webhook;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
#Desenvolvido pela Consultoria Técnica da Gerencianet
bom dia, há alguma forma de eu testar o certificado cacert sem ter que ficar mudando o webhook ?
boa tarde, preciso configurar o webhook do pix na conta do gerencianet mas nao encontro o caminho
Há 3 jeitos:
- Configurar o webhook, você recebe o aviso quando foi depositado na sua conta
- Fazer GET em /cob/:txid, quando for depositado na sua conta vai aparecer um objeto pix
- Fazer GET em /pix com filtro por inicio, fim e txid, quando a resposta for um objeto pix ao invés de uma resposta nula, é pq foi pago (e está a caminho de ser depositado na sua conta)
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 em um servidor dedicado, você deve inserir uma chave pública da Gerencianet nas configurações de 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, Nginx, Node, etc: 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:
json
{
"webhookUrl": "https://seudominio.com.br/webhook"
}
No entanto, as notificações serão enviadas para sua URL com o /pix no final, assim: https://seudominio.com.br/webhook/pix. {
"webhookUrl": "https://seudominio.com.br/webhook"
}
Desta forma, 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 também 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.
Como nenhum Pix é recebido no ambiente de teste, se o end-point /pix funcionar (nunca testei), vai dar sempre lista em branco.
Mas endpoints como /cob e /webhook funcionam em homologação.
Boa trade @tilsonmateus ! Isso mesmo, sugerimos você criar uma cobrança com um valor baixo em produção, de 1 centavo por exemplo, e pagá-la para receber a notificação em seu webhook.
Caso você esteja na conta que vai utilizar em produção e não queira "poluir" os logs dessa conta, você pode abrir uma subconta para fazer estas simulações. Assim não terá impacto na sua conta principal.
Sim. Mas na resposta do webhook a Gerencianet te diz se a transação foi bem sucedida ou não.
Tem como pegar o valor da tarifa sem ser pelo webhook? algum endpoint específico?
400webhook_invalidoA URL informada respondeu com o código HTTP 302
A ativação do webhook dá para testar em homologação. Só o acionamento que só dá para testar em produção.
A API de emissões tem também notificação por webhook.
Bom dia. Estou interessado em desenvolver um sistema que vai emitir boletos e precisa receber a notificação por webhook quanto ao pagamento.
Boa dia, @.guind. Como vai?
Como mencionado pelo Rubens, não é possível simular pagamento ou devolução de uma cobrança Pix gerada em homologação.
Neste caso sugerimos você criar uma cobrança com um valor baixo em produção, de 1 centavo por exemplo, e pagá-la para receber a notificação em seu webhook.
Caso você esteja na conta que vai utilizar em produção e não queira "poluir" os logs dessa conta, você pode abrir uma subconta para fazer estas simulações. Assim não terá impacto na sua conta principal.
Para abrir uma subconta siga o passo a passo: https://gerencianet.com.br/artigo/ter-mais-de-uma-conta-gerencianet