Configuração das subcontas

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

GET /v1/subaccounts/settings

cURL

curl https://bukio-backend-production.up.railway.app/v1/subaccounts/settings \
  -H "Authorization: Bearer bk_live_..."

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

​

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): sale (venda no Pix) e withdrawal (saque), cada uma { percentBps, fixed }.

cURL

curl https://bukio-backend-production.up.railway.app/v1/subaccounts/settings \
  -H "Authorization: Bearer bk_live_..."

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