Termos mais procurados:
@.andregomes, quando você registra o webhook no endpoint PUT /v2/webhook/:chave, você está basicamente associando uma chave Pix a uma URL específica. No seu caso, a URL permanecerá a mesma, mas a chave será única para cada conta de cliente.
Assim que nossa API enviar a notificação, o JSON incluirá essa chave. Isso permitirá que você identifique de qual conta é aquele recebimento. Além disso, através do txid, você poderá saber a qual cobrança se refere.
Bom dia @jhon0029 ! Esse endpoint é utilizado para configurar seu webhook. Se sua url de webhook estiver correta, ao consumir este endpoint, o retorno da API será a propria url, ou seja o mesmo body da requisição enviado e você receberá uma notificação dessa forma:
Boa tarde, @hlyras!
Sugerimos as duas formas de validação a seguir, mas recomendamos fortemente que as utilize em conjunto:
Verifique o IP de comunicação: Você pode restringir a comunicação ao domínio do webhhook cadastrado para aceitar apenas mensagens do IP utilizado pela Efí.
IP utilizado atualmente em nossas comunicações: '34.193.116.226'.
Adicione uma hash à URL cadastrada no webhook: Crie um hmac (uma identificação própria) que será acrescentado ao final da URL no momento do cadastro do webhook. Essa hash será utilizada para validar a origem da notificação. Assim, todos os webhooks enviados ao seu servidor terão essa identificação final e sua aplicação deve validar a presença da mesma.
Exemplo:
URL de notificação original: https://seu_dominio.com.br/webhook
Como deverá ser cadastrada com a hash: https://seu_dominio.com.br/webhook?hmac=xyz&ignorar=. O termo ignorar= servirá para tratar a adição do /pix no final da URL.
Boa tarde, estou criando uma rota na minha api pra gerar boletos utilizando o sdk typescript e o endpoint
@guilherme_efi estou recebendo o retorno correto na minha url de notificação desta forma: id: {"status": "success", "message":"Webhook succeed"} mas percebi que não tá conseguindo pegar o id da transação pra eu fazer update no status do pix... sabe o que pode ser?
obrigado @guilherme_efi a propósito, sabe porque minha notificação de pagamento está retornando isso, já conferi e não achei nada errado na url de notificação do pix:
3500010
property_does_not_exists
Propriedade: "notification". A propriedade [notification] informada não existe.
Alguém poderia me ajudar sobre uma dúvida das notificações do Pix.
Configurei uma url de notificações com o skip-MTLs ativo seguindo esta estrutura: http://urldosite/notifications.php
Porém quando recebo a resposta, vem somente um requisição em branco, e no webhook inbox chega normalmente a notificação.
Alguém consegue me ajudar com isso?
Olá pessoal, tudo bem?
Estou com um problema para receber as notificações do Pix.
Eu cadastro a URL de notificação certinho porem não estou recendo a resposta da transação.
Estou usando com o "x-skip-mtls-checking" => "true" pois o sistema do cliente está um host compartilhado na Hostgator.
Já tentei vários testes porém não recebo resposta na url de notificação.
Boa tarde, @nexus_prime! Tudo bem?
A Efí irá fazer 2 requisições para o seu domínio (servidor):
1. Vamos certificar que seu servidor esteja exigindo uma chave pública da Efí. Para isso, enviaremos uma requisição sem certificado e seu servidor não deverá aceitar a requisição. Caso seu servidor responda com recusa, enviaremos a 2ª requisição. Nesta requisição a notificação é enviada para a URL que registrou.
2. Seu servidor, que deve conter a chave pública disponibilizada, deverá realizar o "Hand-Shake" para que a comunicação seja estabelecida. Nesta segunda é enviada a notificação para a URL registrada + "/pix" no final.
Tendo registrado a URL, todas as notificações serão enviadas para a URL+ /pix.
Para que não tenha que tratar em rota a adição do "/pix", você pode registrar usa URL com um ?ignorar=. Exemplo: https://sua_url.com.br/webhook/?ignorar=. Desta forma você pode tratar a notificação sempre em uma na mesma rota.
Boa noite. Estou tentando configurar o webhook através do endpoint PUT /v2/webhook/:chave, enviei a URL sem trailing slash, mas parece que a barra é adicionada mesmo assim... Testei o pagamento e a requisição de notificação está sendo enviada pra um endpoint //pix (com duas barras)... Na imagem, corpo da requisição à esquerda e corpo da resposta à direita.
Bom dia pessoal, estou com algumas dúvidas relacionadas com a integração via API para o PIX.
Usando o SDK PHP, já consegui gerar as cobranças, associadas com uma chave PIX gerada dentro da minha conta, mas estou um pouco confuso sobre a parte de webhooks de notificação e diferenças entre homologação e produção.
Sobre a parte de Webhooks, eu entendi que preciso cadastrar via API qual é a URL que o Gerencianet deverá notificar quando houver algum evento relacionado com a chave PIX. Até consegui realizar alguns testes utilizando a coleção do postman, gerando a cobrança e recebendo a notificação post da Gerencianet.
Um ponto relacionado com a aplicação que estou trabalhando é que o cliente está em um servidor compartilhado. Vi na documentação que é possível utilizar o parâmetro
Bom dia @grupothx !
Em hospedagem compartilhada não é possível configurar o mTLS por não fornecerem as permissões necessárias.
Não sendo possível configurar o mTLS, você pode configurar uma URL de webhook ignorando esta validação.
Para isto, basta informar o parâmetro x-skip-mtls-checking igual a true no Header da requisição PUT /v2/webhook/:chave que será registrado seu webhook URL sem a validação do mTLS.
Desta forma, caso opte por deixar o x-skip-mtls-checking como true, a Efí vai continuar a enviar o certificado na requisição, mas como mencionado, seu servidor irá ignorá-lo.
No entanto é aconselhável que você encontre uma forma de validar se é a Efí quem está enviando a notificação, pois, sem o mTLS configurado não há o "hand-shake". Uma sugestão é verificar o IP de quem está notificando, pois a Efí comunica os webhook através do IP 34.193.116.226
Estou tentando descobrir quais os status de uma cobrança pix que são enviados para o webhook, para poder construir o webhook do meu lado. Estou usando o template https://github.com/gerencianet/gn-api-sdk-typescript/blob/main/examples/pix/webhooks/pixConfigWebhook.ts para configurar a url gerada no webhookinbox, porém não estou recebendo nenhum evento e quando tento acessar o sistema, para ver as notificações de produção estou recebendo algumas vezes um erro - Erro interno do servidor
E não consigo ver nenhum historico de requisição e notificação, alguém consegue me ajuda?
Olá, boa noite! Tudo bem? 😀
Estou tentando criar meu próprio webhook em PHP (no meu servidor dedicado) para receber as notificações de pagamentos realizados via Pix, e há algum problema, pois não recebo as notificações de pagamentos. Segue o código em PHP abaixo:
header("Content-Type: application/json");
$request = file_get_contents("php://input");
file_put_contents("webhook.json", print_r($request, true));
print_r($request);
?>
Recebo a notificação de configuração do link do webhook normalmente:
{
"webhookUrl": "https://exemplo-pix/webhook"
}
Mas não recebo a notificação quando realizo o pagamento:
{
"pix": [
{
"endToEndId": "E1803615022211340s08793XPJ",
"txid": "fc9a43k6ff384ryP5f41719",
"chave": "2c3c7441-b91e-4982-3c25-6105581e18ae",
"valor": "0.01",
"horario": "2020-12-21T13:40:34.000Z",
"infoPagador": "pagando o pix"
}
]
}
Tentei utilizar o exemplo de configuração de servidor em Python desenvolvido em Flask (https://dev.gerencianet.com.br/v1/docs/api-pix#section-exemplos-de-uma-configura-o-de-servidor-), mas não consegui seguir esse exemplo. ☹️
Já testei em sites de terceiros (como o https://webhook.site), e funciona normalmente (recebi a notificação do pagamento).
O meu servidor possui certificado SSL e a versão do TLS é 1.2.
Preciso receber essas notificações e armazená-las em algum lugar para verificar se o pagamento foi realizado. Vocês podem me ajudar? Irei ficar muito grato! Muito obrigado! 😀
Boa tarde <@!446125987617439744> ! O sistema de notificação do Pix é um pouco diferente da Api de boletos, onde você informa a url de notificação. No pix, você deve cadastrar um webhook para receber essas notificações e para isso você deve ter um servidor configurado com a chave pública da Gerencianet. Em nossa documentação, você encontra mais detalhes sobre essa configuração do webhook.
Me refiro a api e a url de callback onde o gerencianet envia a notificação de liquidação ao meu sistema
Você conseguiu gerar o relatório das cobranças com status Aguardando e a url de notificação?
Olá <@!850502535859929110> ! Boa noite. Para que você receba uma notificação sempre que uma cobrança Pix tiver seu status alterado é necessário definir uma URL para onde a notificação vai ser enviada. Essa definição é feita ao consumir a rota PUT /v2/webhook/:chave (https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-configurar-o-webhook-pix). Mas antes disso, é necessário que você realize algumas configurações no seu servidor. Em nossa documentação, disponibilizamos alguns exemplos: https://dev.gerencianet.com.br/docs/api-pix-endpoints#section-exemplos-de-configura-es-de-servidor.
