Consultar entregas
Confira o que a PayZu enviou ao seu endpoint em cada evento: o status da entrega, as tentativas, a última resposta e o corpo.
Liste as entregas
curl "https://api.sandbox.payzu.dev/v1/webhook-deliveries?webhook_id=whe_oeQa3G4R1B4IW9KNJAiP1l&limit=2" \
-H "Authorization: Bearer SUA_CHAVE_DE_API"A resposta traz as entregas em items, da mais nova para a mais antiga, cada uma no formato da consulta abaixo. Cada página tem até 100 entregas, com next_cursor para a seguinte.
Referência: Listar as entregas dos webhooks
| Filtro | Regra |
|---|---|
webhook_id | Um id que não existe traz a lista vazia. |
status | Um dos status da entrega. |
event_type | Um dos eventos ou ping. |
created_from e created_to | Dia de criação em AAAA-MM-DD, no fuso de São Paulo, com os dois dias incluídos. |
Um valor fora da lista em status ou em event_type responde 400.
As entregas concluídas ficam 30 dias na lista.
As entregas delivered e failed saem da lista 30 dias depois da criação.
Consulte uma entrega
curl https://api.sandbox.payzu.dev/v1/webhook-deliveries/whd_Aduv7DfwwLFCdrFLtEmNrd \
-H "Authorization: Bearer SUA_CHAVE_DE_API"{
"id": "whd_Aduv7DfwwLFCdrFLtEmNrd",
"status": "delivered",
"delivered_at": "2026-11-11T15:21:04.427Z",
"created_at": "2026-11-11T15:21:04.423Z",
"webhook": {
"id": "whe_oeQa3G4R1B4IW9KNJAiP1l",
"url": "https://loja.exemplo.com.br/webhooks/payzu"
},
"event": {
"id": "evt_SIw32SA8RKHmPAx3XUezdx",
"type": "ping"
},
"attempts": {
"count": 2,
"last_at": "2026-11-11T15:21:04.427Z",
"next_at": null,
"last_status_code": 200,
"last_error": null
},
"payload": {
"id": "evt_SIw32SA8RKHmPAx3XUezdx",
"type": "ping",
"created_at": "2026-11-11T15:21:04.422Z",
"data": {
"webhook": {
"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",
"created_at": "2026-11-11T15:20:59.433Z",
"updated_at": "2026-11-11T15:20:59.436Z"
}
}
}
}Referência: Consultar uma entrega
O exemplo é a entrega do evento de teste ping, que o painel envia com o webhook inteiro em data.webhook. Nos outros eventos, payload traz o corpo descrito em Modelo de evento.
| Campo | O que traz |
|---|---|
payload | Corpo do evento como foi guardado na criação da entrega, igual em todas as tentativas e no reenvio. |
webhook.url | Endereço atual do webhook. |
attempts.count | Tentativas feitas. |
attempts.last_at | Momento da última tentativa. |
attempts.next_at | Momento da próxima tentativa. |
attempts.last_status_code | Status HTTP da última resposta, ou null quando o endpoint não respondeu. |
attempts.last_error | Motivo da última falha, como HTTP 500. |
Status da entrega
| Status | O que significa |
|---|---|
pending | Espera a primeira ou a próxima tentativa. |
delivered | Entrega concluída. |
failed | Sexta tentativa sem 2xx, entrega do ping sem 2xx, que não tem nova tentativa, ou reenvio de entrega failed ou delivered que não teve 2xx. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
| - | 404 | Entrega não encontrada para o id informado. |
Os erros de autenticação e de validação estão no Catálogo de erros.