PayZu PixWebhooks e callbacks
Listar os webhooks
Veja os webhooks cadastrados na conta e se as entregas de cada um vão assinadas.
Liste e consulte
active=true filtra os ativos, e hasSecret indica se as entregas vão assinadas.
bash
curl "https://pix.sandbox.payzu.dev/v1/user/webhooks?active=true" \
-H "Authorization: Bearer SEU_TOKEN"json
{
"webhooks": [
{
"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: Listar os webhooks cadastrados
Para um só webhook, use GET /user/webhooks/{id}.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZG404 | 404 | Webhook não encontrado |
Os códigos de autenticação e de validação estão no Catálogo de erros.