Histórico de mensagens sobre webhook

Funcionou para registrar url do webhook, mas estou tentando testar no modo homologação e não está chegando

Estu conseguindo cadastrar o Webhook, porém no log do Apache tá aparecendo um erro, e aí não sei se o erro é por conta que o certificado do client não foi identificado (esperado já que a Efí primeiro faz uma requisição que deve ser rejeitada ) ou se é um erro da implementação do mTLS.

Bom dia pessoal, alguém ai tem alguma solução para testar webhook no localhost? o ngrok n da para baixar o certificado mtls na versão gratuita e na versão paga nao sei se funciona tmb

Bom dia, @israelcosta.
Acredito então, como não vai configurar no Apache ou Nginx o mTLS, você deverá registrar sua webhook URL com o atributo x-skip-mtls-checking=true
Veja mais detalhes e pontos de atenção em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#skip-mtls

Segundo ponto, os callbacks são enviados pela Efí via POST ​/pix quando há uma alteração no status do Pix. Então nestas rotas você deve esperar Route:post.

Por último, adicione também a rota POST '/webhook', pois é feito uma requisição de teste nela também.

Quem já trabalhou com Laravel sabe dizer se funciona dessa maneira ao invés de suar Alias?


use Illuminate\Http\RedirectResponse;

// Redireciona /webhook/pix/ para /webhook
Route::get('/webhook/pix/', function () {
return new RedirectResponse('/webhook');
});

// Redireciona /webhook/pix para /webhook
Route::get('/webhook/pix', function () {
return new RedirectResponse('/webhook');
});

Esse Alias significa dizer que quando houver uma requisição ele vai redirecionar para o arquivo webhook/index.php certo?

No meu caso estou utilizando Laravel


SSLVerifyClient require
SSLVerifyDepth 3


# Tratando o /pix, redirecionando as requisições sempre para /webhook
Alias "/webhook/pix/" "/var/www/webhook/index.php"
Alias "/webhook/pix" "/var/www/webhook/index.php"

Poderia me explicar essa linha?

# Tratando o /pix, redirecionando as requisições sempre para /webhook
Alias "/pix/" "/var/www/webhook/index.php"
Alias "/pix" "/var/www/webhook/index.php"

Essa configuração se dá para o mTLS. Para o skip-mTLS onde você implementa as medidas de segurança, a recomendação é verificar o IP de comunicação da Efí e utilizar uma hash ao final da URL que você vai cadastrar no webhook.

Então se eu fizer uma requisição post para a minha rota do WebHook com um body ele vai rejeitar automaticamente?

Bom dia, @israelcosta!
A Efí realiza duas requisições para o seu servidor, a primeira para testar se você está verificando nossa chave pública e a segunda para estabelecer o Hand-Shake caso ocorra o retorno esperado na primeira. Detalhes dessa comunicação podem ser encontrados nessa página da nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks

Já configurei o WebHook para receber a notificação da API, mas como certificar que quem está enviando a notificação realmente é a API da Efí? Eu vi na doc algo sobre o tratamento desse problema mas não estou conseguindo mais encontrar

Boa tarde, @danteredgrave.! Tudo joia? Não tivemos alterações no webhooks.
Vou criar um atendimento no canal # atendimento para obter mais informações do seu caso

boa tarde houve alguma alteração nos webhooks? aqui simplistemente parou de funcionar. dei uma olhada no log e vi que parou ja faz alguns dias. ele funcionava normal

No test que fiz aqui em sendbox (hom), quando o webhook chamou minha API ela não veio no payload o sendId que eu gerei para fazer o sendPix.
Payload que recebi:

Este webhook eu posso cadastrar uma única vez, certo ? não precisa "recadastrar" toda vez que um pix for enviado né ?

Não, o ideal é você criar uma chave aleatória específica para envios, e cadastrar um webhook para essa chave.

Só uma dúvida,
Eu já estou utilizando o endpoint de PUT /v2/cob/:txid (createCharge) com o webhook cadastrado com a chave da minha empresa.

Agora quando eu faço o envio do pix PUT/v2/gn/pix/:idEnvio (pixSend) tenho que cadastrar outro webhook com chave pix do favorecido (chave de quem vai receber o pix) ?

pessoal estou com esse erro aqui na hora de enviar um pix -> A chave informada não tem webhook cadastrado na conta Gerencianet autenticada

Tá relacionado com o mTSL que desativei na criação do webhook? Passei o parametro skip lá.