Update Subaccount
Atualiza nome, e-mail, metadata ou situação. Envie só o que quer mudar. externalId é imutável: enviar no PUT é 400. active precisa ser boolean de verdade ("false" entre aspas é 400), metadata precisa ser string de até 2048, e nada é truncado em silêncio: fora do limite é 400. Desativar (active: false) impede a subconta de receber novas cobranças e transferências de entrada; cobrança criada ANTES da desativação ainda credita quando paga. O saldo continua consultável e pode ser transferido de volta pra conta principal. Não existe exclusão: o histórico do extrato é permanente.
Authorizations
Chave de API gerada no dashboard da PurinCash (ps_live_ ou ps_test_).
Path Parameters
Body
1002552048Novo markup percentual. Vale só pra vendas futuras.
0 <= x <= 100Novo markup fixo em centavos. Vale só pra vendas futuras.
x >= 0Novo markup percentual de SAQUE. Vale só pra saques futuros. Campo ausente não mexe na taxa; para zerar, mande 0.
0 <= x <= 100Novo markup fixo de saque, em centavos. Campo ausente não mexe na taxa; para zerar, mande 0.
x >= 0Response
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.
ID da subconta, prefixo sacc_. Use em cobranças e consultas.
Seu ID para este cliente. Vazio quando não informado.
Subconta desativada não recebe novas cobranças nem entradas.
Saldo atual do ledger, em centavos.
Total já creditado por vendas, sem descontar transferências.
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.
Markup fixo em centavos, somado ao percentual.
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.
Markup fixo de saque, em centavos, somado ao percentual.
Preso por disputas (MED) desta subconta.
balanceCents − medBlockedCents, nunca negativo.

