PayZu Conta HubWebhooks e callbacks
Listar as entregas
Veja o estado de cada entrega, nos webhooks cadastrados e na callbackUrl, para achar os avisos que o seu endpoint não confirmou.
Liste as entregas
Cada aviso gera uma entrega por destino, num webhook cadastrado ou na callbackUrl da operação. A lista começa pela mais recente e é paginada por cursor, como as outras.
statuseevent: filtram pelo estado e pelo evento.webhookId: separa os webhooks da conta. Nas entregas para acallbackUrl, ele vemnullewebhookUrltraz o endereço da operação.
bash
curl --request GET \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/webhooks/deliveries?status=FAILED&limit=20' \
--header 'Authorization: Bearer SEU_TOKEN'json
{
"data": [
{
"id": "cmu1r7x2k000701s6dlvr0007",
"event": "WITHDRAW_FAILED",
"status": "FAILED",
"attempts": 3,
"responseCode": 500,
"webhookId": "cmu6w1h0k000101s6ef34gh56",
"webhookUrl": "https://sualoja.com.br/webhooks/payzu",
"triggedBy": "cmu3wd7k1000201s6wdrw0001",
"createdAt": "2026-10-05T14:40:15.026Z",
"deliveredAt": null
}
]
}Referência: Listar as entregas dos webhooks
O id da entrega é o mesmo do envelope e do cabeçalho X-Payzu-Delivery, então dá para achar a entrega de um aviso que o seu sistema registrou.
Status da entrega
| Status | Descrição |
|---|---|
PENDING | Entrega ainda sem resposta. |
DELIVERED | Entrega confirmada. |
FAILED | Tentativa sem 2xx, com outra prevista. |
ABANDONED | Tentativas esgotadas. |