# Consultar status do estorno
`GET /v1/wallet/refunds`
**Área:** Estorno Cartão

**Scopes necessários:** `wallet/read`

Consulta se um **estorno de cartão** foi confirmado.

Use o refund (não o status da cobrança) para confirmar:

- `status === "CONFIRMED"` (ou `success === true`): estorno confirmado
- `status === "PROCESSING"`: ainda aguardando
- `status === "ERROR"`: falhou (`error` pode vir preenchido)

Modos de uso:

- Informe `refundId` para o detalhe/polling de um estorno específico.
- Informe `chargeId` para consultar os estornos daquela cobrança de cartão.
- MasterAccounts podem consultar uma subconta informando `accountId`.

> ℹ️ No estorno de cartão a resposta traz `paymentType: "CREDIT_CARD"` e o `providerChargeId` da transação.

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `refundId` | não | - Detalhe/polling de um estorno específico |

### Resposta 200 — Item único (por refundId)

```json
{
    "refundId": "ref_1774531490865_bq4e8v12x",
    "accountId": "429131212",
    "status": "CONFIRMED",
    "success": true,
    "amount": 100.00,
    "reason": "CUSTOMER_REQUEST",
    "chargeId": "cha_1774530966959_frgj3ptax",
    "originalEndToEndId": null,
    "returnIdentification": null,
    "providerChargeId": "prov_ch_9f8a7b6c",
    "paymentType": "CREDIT_CARD",
    "splitReversals": [],
    "error": null,
    "createdAt": "2026-03-26T13:24:52.106Z",
    "updatedAt": "2026-03-26T13:24:57.553Z"
}
```

### Resposta 404 — 404 REFUND_NOT_FOUND

```json
{
    "error": {
        "message": "Refund não encontrado",
        "code": "REFUND_NOT_FOUND",
        "details": null,
        "timestamp": "2026-08-05T12:00:00.000Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/get-consultar-status-do-estorno
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json