> ## 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.

# Mudar a configuração das subcontas

> Muda a taxa global, os limites padrão e o bloqueio automático por MED.

Escopo `subaccounts:update`. Só o dono da conta muda (pessoa da equipe: `403 TEAM_OWNER_ONLY`). Todos os campos são opcionais; o que não vier fica como está.

**saleFeeBps** `integer`

Comissão global por venda em pontos-base (100 = 1%; 0 a 10000).

**saleFeeFixed** `integer`

Parte fixa da comissão global por venda (centavos).

**withdrawFeeBps** `integer`

Taxa global por saque da subconta, em pontos-base.

**withdrawFeeFixed** `integer`

Parte fixa da taxa global por saque (centavos). Ela paga a tarifa do saque da WyzeCash; o que sobra fica com você.

**limits** `object`

`{ perWithdrawal, daily, monthly }` em centavos para as subcontas criadas daqui em diante; `null` tira o limite. Por saque até o do dia e o do dia até o do mês; valor não aceito: `422 INVALID_LIMITS`.

**medAutoLock** `boolean`

Liga ou desliga o bloqueio automático por MED (desligado de início).

## Bloqueio automático por MED

Com `medAutoLock: true`, um MED aberto numa venda de uma subconta que não tem saldo livre para reservar a parte dela:

1. **Tranca o saque da subconta** (`lockMode` vira `withdraw`, ou `full` se ela já não recebia) e marca `medLocked: true`.
2. O que falta fica **pendente na subconta** (`medPending`) e sai das **próximas entradas dela** (venda, envio da principal, transferência), nunca do seu saldo.
3. MED **contestado**: a pendência some. MED **devolvido**: o que a subconta não tinha vira dívida dela, que as próximas entradas pagam a você (movimento `SUB-` "Pendência do MED paga").
4. Sem pendência, a subconta **destrava sozinha**.

Mudar o `lockMode` da subconta na mão tira a marca do automático (a pendência continua sendo cobrada das entradas). Subconta com MED em andamento não pode ser excluída (`409 SUBACCOUNT_BUSY`).

## Resposta

A configuração salva, no formato de [Configuração das subcontas](https://docs.wyzecash.com.br/referencia/subcontas/configuracao-das-subcontas.md).

```bash cURL theme={null}
curl -X PUT https://api.wyzecash.com.br/v1/subaccounts/settings \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "saleFeeBps": 500, "withdrawFeeFixed": 100, "limits": { "perWithdrawal": 50000 }, "medAutoLock": true }'
```

```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.