Histórico de mensagens sobre webhook

Obrigado achei aqui o exemplo. A ideia é configurar o webhook "só uma vez" né ?

Agora estou recebendo, porém o body está vindo vazio, sem o x-www-form-urlencoded, dai minha api não valida a requisição ao webhook

Fiz tudo isso, o problema era receber as notificações mesmo, tinha incluido o webhook de boleto no mTLS, o que não era preciso fazer. Por isso não recebia notificações no endpoint de boleto

Não, no site nem dá. É via API também.
https://dev.efipay.com.br/docs/api-pix/webhooks

Pix não tem notification_url por transação. Tem que configurar webhook para a chave Pix, aí toda cobrança daquela chave é notificada nesse webhook.

O .crt de produção para validação do webhook é diferente do de homologação. Precisa trocar o arquivo.

Sim, fiz isso. Consigo gerar pix, boleto e pagamentos com cartão. Porem o webhook não funciona

Uma outra dúvida, é necessário que a porta do servidor esteja na 443 para configurar os webhooks? Como estou tentando implementar através do servidor compartilhado da digital ocean não tenho acesso para alterar e ele só abre na 8080.

Boa tarde estou tendo problemas com webhook, fiz todos os teste no servidor com as credenciais e certificado de homologação e tudo funcionou. Mas agora que mudei pra produção não consigo receber as notificações. Meu nginx retorna 403 nessa linha

Sim, você precisa fornecer a sua URL no atributo webhookUrl, que deve estar pronta para receber as notificações da nossa parte. O cadastro do webhook ocorre apenas uma vez. Assim que for cadastrado, sempre que houver um pagamento associado à sua chave, você será notificado automaticamente.

Eu li isso mas não consegui entender exatamente o que fazer, esse é o corpo que devo enviar nesse PUT, certo?

{
"webhookUrl": "https://exemplo-pix/webhook"
}

Mas em qual momento eu devo fazer isso?

Boa tarde, @hlyras!
O cadastro do webhook é realizado através do endpoint PUT /v2/webhook/:chave
Onde :chave é a chave Pix que você deseja cadastrar o webhook.
Você pode consultar mais informações sobre este procedimento em nossa documentação técnica: https://dev.efipay.com.br/docs/api-pix/webhooks

Onde eu cadastro a url para receber o webhook?

Olá, @andrebarbosa_dev!
O txid atrelado ao endToEndId informado no webhook é mesmo o 6ad1e5c221184cfb951cc04f5b3602c1

Qual a probabilidade de quando gerar um pix imediato ele salvar um txtid e no webhook ele enviar um diferente?

Request webhook pedido: [{"endToEndId":"E18236120202404032158s08da2fd4ba","txid":"6ad1e5c221184cfb951cc04f5b3602c1","chave":"","valor":"1.05","horari esse foi o txtid que chegou no webhook, mas no pedido esta salvo outro:

7a518efe0b9b42c58bec39ad601208ba

Sim, mas no caso eu consigo fazer a verificação do mTLS na rota do webhook e não na configuração do servidor, certo?

$api = $api->pixDetailWebhook($params);

"erro": "Método 'pixGetWebhook' solicitado inexistente"

Na nova sdk qual é o metodo que chama? ao inves do getInstance?

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, tenho um SaaS hospedado na Digital Ocean através de um servidor compartilhado, eu vi que na documentação existe uma forma de receber o webhook da API PIX sem precisar do servidor dedicado:
"Por isso, disponibilizamos a opção skip mTLS, que permite o cadastro do webhook sem a necessidade de validação mTLS."
Seria muito mais prático para eu implementar dessa forma, tem algum código ou vídeo onde explica como fazer as verificações de segurança?