PayZu PixConta e relatórios
Consultar uma transação
Veja uma transação com os envios de callback e as infrações MED ligadas a ela, que não vêm na lista.
Consulte uma transação
bash
curl https://pix.sandbox.payzu.dev/v1/user/transactions/PAYZU20260810JD4WQ2R7ZB000000 \
-H "Authorization: Bearer SEU_TOKEN"json
{
"id": "PAYZU20260810JD4WQ2R7ZB000000",
"status": "COMPLETED",
"amount": 100,
"type": "DEPOSIT",
"method": "PIX",
"qrCodeText": null,
"qrCodeBase64": null,
"qrCodeUrl": null,
"generatedName": "Fulano de Tal",
"generatedDocument": "12345678901",
"generatedEmail": null,
"payerName": "Fulano de Tal",
"payerDocument": "12345678901",
"payerInstitutionIspb": "12345678",
"payerInstitutionName": "Banco X",
"payerAccountNumber": null,
"serviceFeeCharged": 1.5,
"withdrawPixKey": null,
"withdrawPixType": null,
"receiverName": "Loja Exemplo",
"receiverDocument": "11222333000181",
"receiverInstitutionIspb": "00000000",
"receiverInstitutionName": "PayZu",
"receiverAccountNumber": "000000",
"endToEndId": "E12345678202508101200abcdef01234",
"clientReference": "pedido-42",
"refundEndToEndId": null,
"refundAmount": 30.5,
"refundStatus": "PENDING",
"refundReason": "CUSTOMER_REQUEST",
"refundDescription": "Devolução parcial",
"refundedAt": null,
"cancellationReason": null,
"paidAt": "2026-08-10T12:00:00.000Z",
"createdAt": "2026-08-10T11:59:00.000Z",
"updatedAt": "2026-08-11T09:00:00.000Z",
"CallbackLog": [
{
"id": "7c1e0f4a-3b52-4d1e-9a6b-2f8d5c3e1a90",
"url": "https://exemplo.com.br/webhooks/payzu",
"status": 200,
"responseTime": 182,
"createdAt": "2026-08-10T12:00:02.000Z"
}
],
"Infraction": [
{
"id": "d4b8a2e6-5f13-4c07-8e9a-1b3c7d9f2a64",
"status": "WAITING_PSP",
"createdAt": "2026-08-11T08:30:00.000Z",
"updatedAt": "2026-08-11T09:00:00.000Z"
}
]
}Referência: Consultar uma transação
| Bloco | O que traz |
|---|---|
CallbackLog | O status HTTP que o seu endpoint retornou em cada envio, para saber se um callback chegou. |
Infraction | As infrações MED ligadas à transação. |
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZG404 | 404 | Transação não encontrada |
Os códigos de autenticação e de validação estão no Catálogo de erros.