PayZu Conta HubWebhooks e callbacks
Alterar um webhook
Troque o endereço ou os eventos de um webhook, ou pause os avisos dele.
Altere o webhook
Envie ao menos um destes campos.
| Campo | Efeito |
|---|---|
url | O novo endereço. |
events | A nova lista substitui a anterior. |
isActive | false para os avisos na hora; true volta a enviá-los. |
bash
curl --request PUT \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/webhooks/cmu6w1h0k000101s6ef34gh56' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--data '{ "isActive": false }'json
{
"id": "cmu6w1h0k000101s6ef34gh56",
"url": "https://sualoja.com.br/webhooks/payzu",
"events": ["PAYMENT_PAID", "PAYMENT_EXPIRED", "WITHDRAW_COMPLETED", "WITHDRAW_FAILED"],
"isActive": false,
"createdAt": "2026-10-01T12:00:00.000Z",
"updatedAt": "2026-10-06T09:00:00.000Z"
}Referência: Alterar um webhook
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
WEBHOOK_NOT_FOUND | 404 | Webhook não encontrado. |
WEBHOOK_DUPLICATED_URL | 409 | Já existe um webhook com esta URL nesta conta. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.