# Saque subconta
`POST /v1/wallet/withdraw`
**Área:** Saques

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

Com esta funcionalidade você pode criar um saque em uma subconta associada à sua _master account._

> ⚠️ **Atenção:** Só é possível fazer saques para contas de mesma titularidade

### Request body

```json
{
  "amount": 1.00,
  "pixKey": "12345678925",
  "pixKeyType": "CPF",
  "accountId": "258965356" 
}
```

### Campos do body

**Obrigatórios:** `amount`, `pixKey`, `pixKeyType`, `accountId`

| Campo | Descrição |
|---|---|
| `amount` | Valor do saque |
| `pixKey` | Chave Pix de destino |
| `pixKeyType` | tipo de chave Pix |
| `accountId` | Número da subconta de destino |

### Resposta 200 — Sucesso

```json
{
    "withdrawalId": "wdr_1772883158760_tdhomd8xe",
    "status": "PROCESSING",
    "amount": 1,
    "accountNumber": "258965356"
}
```

### Resposta 401 — Acesso negado

```json
{
    "error": {
        "message": "Subconta nao pertence a esta conta",
        "code": "OWNERSHIP_MISMATCH",
        "details": null,
        "timestamp": "2026-03-17T04:01:14.653Z"
    }
}
```

### Resposta 400 — Bloqueio por titularidade

```json
{
    "error": {
        "message": "A chave PIX nao pertence ao titular da conta",
        "code": "OWNERSHIP_MISMATCH",
        "details": null,
        "timestamp": "2026-03-17T04:01:57.811Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/post-saque-subconta
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json