PayZu PixWebhooks e callbacks
Histórico de callbacks
Veja as tentativas de entrega dos dois canais e ache as que terminaram em erro.
Confira o histórico
bash
curl "https://pix.sandbox.payzu.dev/v1/user/callbacks?transactionId=PAYZU20261022F7HD2NQ4XR000000&limit=10" \
-H "Authorization: Bearer SEU_TOKEN"json
{
"pagination": { "page": 1, "limit": 10, "hasNextPage": true },
"callbacks": [
{
"id": "cmh211yjm03ohs601kf7672du",
"url": "https://great-lock-79.webhook.cool",
"status": 200,
"transactionId": "PAYZU20261022F7HD2NQ4XR000000",
"createdAt": "2025-10-22T13:26:53.219Z",
"responseTime": 124,
"body": { "id": "PAYZU20261022F7HD2NQ4XR000000", "type": "DEPOSIT", "status": "REFUNDED" },
"responseBody": "OK",
"responseHeaders": { "content-type": "text/plain; charset=UTF-8" }
}
]
}Referência: Listar os callbacks enviados
| Filtro | O que faz |
|---|---|
hasError=true | Deixa só as tentativas que terminaram em erro: status fora de 2xx, timeout ou conexão recusada. Sem resposta, o status fica -1. |
transactionId, webhookId, eventType | Restringem a uma transação, a um webhook ou a um evento. |
createdAtFrom, createdAtTo | Restringem ao período. |
Para ver uma tentativa inteira, use GET /user/callbacks/{id}.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZG404 | 404 | Log de callback não encontrado |
Os códigos de autenticação e de validação estão no Catálogo de erros.