Skip to main content
PUT
Update Subaccount

Authorizations

Authorization
string
header
required

Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).

Path Parameters

id
string
required

Body

application/json
name
string
Maximum string length: 100
email
string
Maximum string length: 255
metadata
string
Maximum string length: 2048
active
boolean
feePercent
number

Novo markup percentual. Vale só pra vendas futuras.

Required range: 0 <= x <= 100
feeFixedCents
integer

Novo markup fixo em centavos. Vale só pra vendas futuras.

Required range: x >= 0
payoutFeePercent
number

Novo markup percentual de SAQUE. Vale só pra saques futuros. Campo ausente não mexe na taxa; para zerar, mande 0.

Required range: 0 <= x <= 100
payoutFeeFixedCents
integer

Novo markup fixo de saque, em centavos. Campo ausente não mexe na taxa; para zerar, mande 0.

Required range: x >= 0

Response

Subconta atualizada, no MESMO shape do GET individual (inclui medBlockedCents e availableCents): dá pra jogar a resposta direto no seu cache sem perder os dois campos.

subaccountId
string

ID da subconta, prefixo sacc_. Use em cobranças e consultas.

name
string
email
string
externalId
string

Seu ID para este cliente. Vazio quando não informado.

active
boolean

Subconta desativada não recebe novas cobranças nem entradas.

balanceCents
integer

Saldo atual do ledger, em centavos.

totalReceivedCents
integer

Total já creditado por vendas, sem descontar transferências.

feePercent
number

Markup percentual da plataforma sobre cada venda desta subconta (0 a 100, até 2 casas). Descontado do líquido ANTES do crédito; a fatia fica na conta principal.

feeFixedCents
integer

Markup fixo em centavos, somado ao percentual.

payoutFeePercent
number

Markup percentual sobre cada SAQUE desta subconta (0 a 100, até 2 casas). A subconta é debitada o valor cheio e o PIX sai pelo líquido: a diferença fica na conta principal.

payoutFeeFixedCents
integer

Markup fixo de saque, em centavos, somado ao percentual.

metadata
string
createdAt
string<date-time>
updatedAt
string<date-time>
medBlockedCents
integer

Preso por disputas (MED) desta subconta.

availableCents
integer

balanceCents − medBlockedCents, nunca negativo.