PayZu Conta HubWebhooks e callbacks
Consultar uma entrega
Veja o que foi enviado numa entrega e o que o seu endpoint respondeu.
Consulte pelo id
bash
curl --request GET \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/webhooks/deliveries/cmu1r7x2k000701s6dlvr0007' \
--header 'Authorization: Bearer SEU_TOKEN'json
{
"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,
"payload": {
"event": "WITHDRAW_FAILED",
"id": "cmu1r7x2k000701s6dlvr0007",
"sentAt": "2026-10-05T14:40:15.026Z",
"accountId": "cmu0z8k2a000001s6acct0001",
"data": {
"withdrawId": "P20261005114011R4D8TN2WQZC127431",
"status": "FAILED",
"operation": "WITHDRAW",
"amount": 10000,
"serviceFee": 250,
"totalDebited": 10250,
"pixKey": "fulano@exemplo.com",
"reason": "Não foi possível concluir esta operação."
}
},
"responseBody": "{\"error\":\"internal\"}"
}Referência: Consultar uma entrega de um webhook
payload: o corpo enviado.responseBody: os primeiros 500 caracteres da última resposta do seu endpoint.- Sem resposta:
responseCodevemnulleresponseBodytraz o motivo da falha de rede.
Depois de um prazo, o corpo das entregas DELIVERED e ABANDONED é mascarado.
Ele passa a trazer _purgedAt, e a entrega não pode mais ser reenviada.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
WEBHOOK_DELIVERY_NOT_FOUND | 404 | Entrega de webhook não encontrada. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.