# Criar estorno de cartão
`POST /v1/wallet/refunds`
**Área:** Estorno Cartão

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

Cria um **estorno de cartão de crédito** a partir do `chargeId` da cobrança original. O estorno pode ser parcial ou total.

> ℹ️ Para cartão, o estorno pode retornar `CONFIRMED` na hora, quando a confirmação vem imediatamente — nesse caso o polling não é necessário (`success` já vem `true`).

Se vier `PROCESSING`, guarde o `refundId` e acompanhe pela rota **Consultar status do estorno** (`GET /v1/wallet/refunds`).

### Request body

```json
{
  "accountId": "459013777",
  "chargeId": "cha_1774530966959_frgj3ptax",
  "amount": 100.00,
  "reason": "CUSTOMER_REQUEST"
}
```

### Campos do body

**Obrigatórios:** `chargeId`, `amount`

| Campo | Descrição |
|---|---|
| `chargeId` | ID da cobrança de cartão a ser estornada. |
| `amount` | Valor do estorno (parcial ou total). |

**Opcionais**

| Campo | Descrição |
|---|---|
| `accountId` | Número da subconta. Se omitido, opera na conta principal. |
| `reason` | Motivo do estorno. |

### Resposta 201 — Sucesso

```json
{
    "refundId": "ref_1774531490865_bq4e8v12x",
    "status": "CONFIRMED",
    "success": true,
    "amount": 100,
    "reason": "CUSTOMER_REQUEST",
    "chargeId": "cha_1774530966959_frgj3ptax",
    "providerChargeId": "prov_ch_9f8a7b6c",
    "paymentType": "CREDIT_CARD",
    "createdAt": "2026-03-26T13:24:52.106Z"
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/post-criar-estorno-de-cartao
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json