Histórico de mensagens sobre webhook em pix

Boa noite, pessoal. Estou terminando a integração com a API Pix e achei tudo muito prático, apanhei um pouco para o webhook com mTLS mas ainda bem que vi aqui sobre o parametro para ignorar o mTLS, bem mais fácil hehe 🙂 Poderiam adicionar o parametro na documentação para mais pessoas saberem sobre o parametro.

Boa tarde, <@!798679248633856000>! Exatamente conforme explicado pelo Rubens. As notificações são enviadas através de uma requisição POST para seu webhook cadastrado, passado no body as informações pertinentes ao Pix, sempre em um array.

<@!780500321994539068> voce sabe o pq a resposta do webhook vem em uma array?

galera eu to confuso com um ponto da documentação,

> Callbacks
> Esse serviço está protegido por uma camada de autenticação mTLS. Os callbacks são enviados pela Gerencianet via POST {$request.body#​/webhookUrl}​/pix quando há uma alteração no status do PIX.
>

No webhook a notificação do envio fica assim:

É um certificado único para a aplicação, sendo um para cada ambiente. Segue link dos certificados que contém as chaves públicas da Gerencianet que você utilizará para o mTLS:
Desenvolvimento: https://pix.gerencianet.com.br/webhooks/chain-pix-sandbox.crt
Produção: https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt

<@!664563985885954079>, tente enviar a requisição passando o body da seguinte forma:

estou utilizando o endpoint de configuração de webhooks

Então neste caso o mTLS ainda não está configurado e devido a isso não teve o cadastro da sua chave com o webhook

<@!671762828046106646> {#1325
+"nome": "webhook_invalido"
+"mensagem": "A autenticação de TLS mútuo não está configurada na URL informada"
}

pois acessei https://api-pix.gerencianet.com.br/v2/webhook/{meu token}

Utilize o GET /v2/webhook/:chave e verifique se foi cadastrado

Esse evento é quando o webhook é cadastrado com sucesso, então o seu ambiente está correto

Para você receber as notificações de Pix recebidos e devoluções, você precisa que ocorra uma transação associada a esta chave cadastrada no webhook

Esse evento é de cadastro do webhook, para receber as informações do Pix, a chave cadastrada deve ter um Pix recebido

PS: meu webhook eu passo o tls = 0

configurei o webhook para savar o retorno em um arquivo

Bom dia <@!664563985885954079>, é necessário sim que você configure em seu servidor para que ocorra o mTLS. Neste caso você precisa inserir o nosso CA em seu VirtualHost e com isso o hand-shake vai ser feito com o CA enviado pela Gerencianet quando é consumido a rota PUT /v2/webhook/:chave.

Bom dia, então queria saber se para configurar os webhooks preciso ja ter o mTLS configurado ou posso dar um PUT na rota de configuração tranquilamente?

CURLOPT_POSTFIELDS => json_encode([
"webhookUrl" => $url
]),