Histórico de mensagens sobre webhook em devs

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

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

Agora você precisa colocar a tratativa para receber as notificações na rota /webhook/pix

{
"webhookUrl": "https://seudominio.com.br/api/webhook"
}

Exato. Essa é uma definição do banco central, que ao enviar a notificação deve ser adicionado o /pix no final da sua URL registrada.

Ou seja, na request PUT https://api-pix.gerencianet.com.br/v2/webhook/:chave você irá passar o body com sua URL, exemplo:

Olhando o log percebi que a API envia o post adicionando um prefixo "/pix" ao WebHook e deve ser por isso que tá dando 404.

Guilherme, já configurei o webhook no meu código, e quando eu vou criar o sistema até recebe a notificação de criação do webhook, mas na hora que vou efetuar o pagamento de um valor o sistema não tá recebendo a notificação, se a mensagem de sucesso de criação do webhook foi recebecida não era par dar certo a notificação do pagamento?

Boa tarde, na notificação que a APi retorna para o WebHook vem somente esses atributos:

{
"pix": [
{
"endToEndId": "E18236120202306111751s061d2234ff",
"txid": "11fd8cebbe7648f29119b8bdb79792e3",
"chave": "2b14b01e-e585-48ff-86ac-3b63b540850c",
"valor": "0.01",
"horario": "2023-06-11T17:51:18.000Z"
}
]
}


Ou tem mais atributos opcionais?

Estou utilizando um request bin (Pipedream) para ver a requisição, mas a API me retorna esse .json:

{
"nome": "webhook_invalido",
"mensagem": "A autenticação de TLS mútuo não está configurada na URL informada"
}

Bom dia, @higris!
Você pode criar um certificado com Certbot (https://certbot.eff.org/instructions) para preencher os campos referentes ao certificado do domínio.

Já o certificado público da Efí, você pode baixar diretamente através dos links abaixo:
Produção: https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt
Homologação: https://pix.gerencianet.com.br/webhooks/chain-pix-sandbox.crt
Você os encontra também em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#exemplos-de-configura%C3%A7%C3%B5es-de-servidor

Então, como você ainda não tem um servidor configurado, pode testar com uma url gerada no https://webhook.site, por exemplo, passando essa parâmetro como true.

Boa tarde time. Eu estou implementando o webhook para PIX e estou com certas dificuldades de entender / implementar elas. Estou seguindo o github do gn-node.js.
Nessa função que criei, basicamente copia e cola do github. Ao tentar rodar a mesma, eu recebo o seguinte erro :
{
chave: 'format',
caminho: '.body.webhookUrl',
mensagem: 'a validação do formato falhou "url"'
}
Não sei se o fato de eu estar usando localhost para a webhookurl está ocasionando isso, mas por enquanto minha aplicação só funciona em localhost, então gostaria de idéia ou feedback de voces, mais experts kk, estou começando a jornada por agora.
Se veem que precisa de mais algum dado pra checar, só pedir que eu envio !