PayZu PixWebhooks e callbacks
Alterar um webhook
Troque a URL ou os eventos de um webhook, ou pause as entregas sem excluir o cadastro.
Altere ou pause
Envie pelo menos um campo.
bash
curl -X PATCH https://pix.sandbox.payzu.dev/v1/user/webhooks/cm3w7k1t40000q8f2r5b9x3ad \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "active": true }'json
{
"id": "cm3w7k1t40000q8f2r5b9x3ad",
"url": "https://sualoja.com.br/webhook",
"active": true,
"events": ["TRANSACTION_COMPLETED", "TRANSACTION_REFUNDED"],
"hasSecret": true,
"createdAt": "2026-08-10T12:00:00.000Z",
"updatedAt": "2026-08-10T12:00:00.000Z"
}Referência: Alterar um webhook
| Campo | Efeito |
|---|---|
url | Vale para todo envio seguinte, inclusive retentativas que já estavam na fila. |
events | Substitui a lista inteira. |
active | false pausa e true reativa. |
Pausar descarta os avisos.
Os eventos do período e as retentativas pendentes não são entregues, não aparecem em GET /user/callbacks e não voltam ao reativar. Para repor o período, consulte as transações em GET /user/transactions.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZA204 | 403 | Conta bloqueada para alterações. Desbloqueie a conta antes de alterar. |
PZG404 | 404 | Webhook não encontrado |
PZG409 | 409 | Limite de 5 webhooks ativos atingido |
Os códigos de autenticação e de validação estão no Catálogo de erros.