# Consultar status da devolução PIX
`GET /v1/wallet/refunds`
**Área:** Devolução Pix

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

Consulta se uma **devolução PIX** foi confirmada.

Não use o status da cobrança (`REFUNDED` / `PARTIALLY_REFUNDED`) para saber se o estorno foi confirmado — use o refund:

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

Modos de uso:

- Informe `refundId` (ou `returnIdentification`) para o detalhe/polling de uma devolução específica.
- Informe `endToEndId` do PIX original para consultar as devoluções daquele pagamento.
- MasterAccounts podem consultar uma subconta informando `accountId`.

Precedência: `refundId` > `returnIdentification` > `endToEndId` > `chargeId`.

> ℹ️ Polling sugerido: 2–5s com timeout (60–120s).

### Query parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `refundId` | não | - Detalhe/polling de uma devolução específica |

### 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": "E0036030520260326132336e2f8787c4",
    "returnIdentification": "D13935893202603261324C5jA3zE3V6J",
    "providerChargeId": null,
    "paymentType": null,
    "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-da-devolucao-pix
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json