Histórico de mensagens sobre webhook

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
]),

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

ta passando o body com a url que o GN vai chamar? seusite.com/webhook

estou tendo esse erro quando tento configurar o webhook

<@!775350441965649951>, com essa mudança para o webhook, é so eu fazer o pedido para n usar o tls, e tenho q fazer algo no meu server para receber o webhook ?

Não necessariamente, <@!664563985885954079>.

Conforme publicamos ontem, você adicionando o parâmetro x-skip-mtls-checking no header no endpoint PUT /v2/webhook/:chave, você irá registrar seu webhook à sua chave sem validação de mTLS durante o consumo.

Ou seja:
Se o parâmetro não for enviado, iremos validar mTLS;
Se o parâmetro for enviado e valor igual à true, não validaremos mTLS;
Se o parâmetro for enviado e valor diferente de true, validaremos mTLS;

Salientamos que a Gerencianet continuará a fornecer a comunicação com mTLS, ou seja, na comunicação da notificação nada mudou. O POST entre Gerencianet e EC continua enviando o certificado.

mais é necessario ter isso configurado para configurar os webhooks?

serio que é só isso?

configuro o nginx pra servir minha api, e especifico que em algum path tipo o webhook ele tem que verificar o client?

$ssl_client_verify
returns the result of client certificate verification: “SUCCESS”, “FAILED:reason”, and “NONE” if a certificate was not present;

e coloco o path no ssl_client_certificate ?

posso utilizar essas chaves para os webhooks??