> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wyzecash.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuração das subcontas

> A taxa global, os limites padrão das subcontas novas e o bloqueio automático por MED.

Escopo `subaccounts:get`. Uma configuração por conta; sem nenhuma salva, tudo vem zerado e desligado.

* **Taxa global** (`saleFee` e `withdrawFee`): vale para toda subconta com `feeMode: "global"`. A subconta criada sem nenhuma taxa no pedido nasce na global; com alguma taxa, fica com a própria (`custom`). Mudar a global muda todas as que seguem a global, nas próximas vendas e saques.
* **Limites padrão** (`limits`): copiados para cada subconta criada depois (o que o pedido de criação manda vale por cima). `null` = sem limite próprio.
* **Bloqueio automático por MED** (`medAutoLock`): veja [Mudar a configuração](https://docs.wyzecash.com.br/referencia/subcontas/mudar-configuracao.md).

## Resposta

**saleFee** `object`

`{ percentBps, fixed }`: a sua comissão por venda (pontos-base e centavos).

**withdrawFee** `object`

`{ percentBps, fixed }`: a sua taxa por saque da subconta. Ela paga a tarifa do saque da WyzeCash; o que sobra fica com você.

**limits** `object`

`{ perWithdrawal, daily, monthly }` em centavos; `null` = sem limite.

**medAutoLock** `boolean`

Bloqueio automático por MED ligado.

**subaccounts** `object`

`{ global, custom }`: quantas subcontas seguem a taxa global e quantas têm a própria.

**platform** `object`

A tarifa da WyzeCash na sua conta (a mesma de [`GET /v1/fees`](https://docs.wyzecash.com.br/endpoints/saldo)): `sale` (venda no Pix) e `withdrawal` (saque), cada uma `{ percentBps, fixed }`.

```bash cURL theme={null}
curl https://api.wyzecash.com.br/v1/subaccounts/settings \
  -H "Authorization: Bearer bk_live_..."
```

```json 200 theme={null}
{
  "saleFee": { "percentBps": 500, "fixed": 0 },
  "withdrawFee": { "percentBps": 0, "fixed": 100 },
  "limits": { "perWithdrawal": 50000, "daily": null, "monthly": null },
  "medAutoLock": true,
  "subaccounts": { "global": 12, "custom": 3 },
  "platform": { "sale": { "percentBps": 0, "fixed": 50 }, "withdrawal": { "percentBps": 0, "fixed": 50 } },
  "updatedAt": "2026-10-20T12:00:00.000Z"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.