PayZu GatewayEstornos e contestações
Consultar uma contestação
Confira o status antes de responder: só a contestação received aceita aceite ou defesa.
Consulte pelo id
bash
curl https://api.sandbox.payzu.dev/v1/chargebacks/chb_4TnW8xQcLb2MzYv7KdRh3E \
-H "Authorization: Bearer SUA_CHAVE_DE_API"json
{
"id": "chb_4TnW8xQcLb2MzYv7KdRh3E",
"status": "received",
"amount": 15990,
"issued_at": "2026-11-20T12:02:11.000Z",
"defense_deadline": "2026-11-30T02:59:59.000Z",
"created_at": "2026-11-20T12:05:48.220Z",
"updated_at": "2026-11-20T12:05:48.220Z",
"dispute": {
"code": "10.4",
"description": "Fraude em compra sem o cartão presente"
},
"response": null,
"invoice": {
"id": "in_7Kd2QmXvB9LtYc4WnRz8Hs",
"status": "chargedback",
"url": "https://invoice.payzu.com.br/pay/in_7Kd2QmXvB9LtYc4WnRz8Hs",
"external_reference": "pedido-1234"
}
}Referência: Consultar uma contestação
| Campo | O que traz |
|---|---|
amount | O valor contestado, em centavos. |
issued_at | A data de emissão na adquirente. |
defense_deadline | O prazo para responder. |
dispute | O motivo informado pela bandeira, em code e description. Os dois podem vir null. |
response | A resposta registrada, com action, note, file_name e sent_at. Vem null enquanto não há resposta. |
invoice | A fatura contestada. |
Liste as contestações
A lista de GET /v1/chargebacks vem da mais nova para a mais antiga.
| Filtro | O que traz |
|---|---|
status | As contestações nesse status. Com status=received, as que esperam resposta. |
invoice_id | As contestações de uma fatura. |
created_from e created_to | As criadas no período, em dias no formato AAAA-MM-DD, no fuso de São Paulo. |
A lista aceita também cursor e limit, como em Paginação. Outro parâmetro na query é ignorado.
Erros desta operação
| Código | HTTP | Mensagem |
|---|---|---|
PZ600 | 404 | Contestação não encontrada para o id informado. |
Os erros de autenticação e de validação estão no Catálogo de erros.