PayZu GatewayWebhooks

Trocar o segredo do webhook


Gere um segredo novo para o webhook, sem mudar o endereço nem os eventos dele.

Troque o segredo

bash
curl -X POST https://api.sandbox.payzu.dev/v1/webhooks/whe_oeQa3G4R1B4IW9KNJAiP1l/rotate-secret \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Referência: Trocar o segredo de um webhook

O segredo novo vem em secret só nesta resposta. A troca ignora o cabeçalho Idempotency-Key: cada chamada gera outro segredo e invalida o da chamada anterior.

O segredo anterior deixa de valer na hora.

A PayZu assina no momento do envio, então toda entrega que sair depois da troca usa o segredo novo, inclusive as novas tentativas de eventos anteriores. Atualize sua aplicação logo em seguida: o que o seu endpoint recusar nesse intervalo volta nas novas tentativas ou pode ser reenviado.

Erros desta operação

CódigoHTTPMensagem
-404Webhook não encontrado para o id informado.

Os erros de autenticação estão no Catálogo de erros.