PayZu Conta HubConta
Consultar uma infração
Consulte pelo protocol, que vem no webhook INFRACTION_OPENED e na listagem.
Consulte pelo protocolo
bash
curl --request GET \
--url 'https://api.sandbox.payzu.dev/api/v1/transactions/infractions/b1c2d3e4-5f60-4a7b-8c9d-0e1f2a3b4c5d' \
--header 'Authorization: Bearer SEU_TOKEN'json
{
"protocol": "b1c2d3e4-5f60-4a7b-8c9d-0e1f2a3b4c5d",
"type": "REFUND_REQUEST",
"status": "OPEN",
"reportedBy": "DEBITED_PARTICIPANT",
"reportDetails": "Cliente não reconhece a compra.",
"analysisResult": null,
"analysisDetails": null,
"endToEndId": "E99999999202610051433a1b2c3d4e5f",
"blockedAmount": 1500,
"feeCharged": 0,
"settledAmount": 0,
"reportedAt": "2026-10-06T10:00:00.000Z",
"dueAt": "2026-10-13T10:00:00.000Z",
"closedAt": null,
"origin": {
"kind": "PAYMENT",
"amount": 1500,
"paidAt": "2026-10-05T14:33:10.004Z",
"payerName": "Maria Souza",
"payerDocument": "***.982.247-**"
}
}Referência: Consultar uma infração MED
dueAt: o prazo para responder.origin.kind: diz se o Pix contestado pagou uma cobrança ou caiu como depósito. OpaymentIdou odepositIdvem no webhook.
Os avisos não trazem todos os campos. Para o estado atual e para estes, use a consulta:
typereportedByanalysisDetails
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
INFRACTION_NOT_FOUND | 404 | Contestação não encontrada. |
Todos os códigos do PayZu Conta Hub estão no Catálogo de erros.