Mudar a configuração das subcontas

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

PUT /v1/subaccounts/settings

cURL

curl -X PUT https://bukio-backend-production.up.railway.app/v1/subaccounts/settings \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "saleFeeBps": 500, "withdrawFeeFixed": 100, "limits": { "perWithdrawal": 50000 }, "medAutoLock": true }'

200

{
  "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"
}

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.

cURL

curl -X PUT https://bukio-backend-production.up.railway.app/v1/subaccounts/settings \
  -H "Authorization: Bearer bk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "saleFeeBps": 500, "withdrawFeeFixed": 100, "limits": { "perWithdrawal": 50000 }, "medAutoLock": true }'

200

{
  "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"
}