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"json
{
"id": "whe_oeQa3G4R1B4IW9KNJAiP1l",
"status": "active",
"url": "https://loja.exemplo.com.br/webhooks/payzu",
"description": "Sistema de pedidos",
"events": ["invoice.paid", "invoice.refunded", "subscription.canceled"],
"masked_secret": "****0000",
"secret": "-lobN1qfwI-_xHx6ob6wrpxnjw496IapHJDV2xW0000",
"created_at": "2026-11-11T15:20:59.433Z",
"updated_at": "2026-11-11T15:20:59.436Z"
}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ódigo | HTTP | Mensagem |
|---|---|---|
| - | 404 | Webhook não encontrado para o id informado. |
Os erros de autenticação estão no Catálogo de erros.