Autenticação

Bearer Token = API Key do master. Escopo subaccounts:write. Sem a flag → 404.

Excluir subconta (soft delete)

Escopo: subaccounts:write

Exclui logicamente (soft delete) a subconta: marca deletedAt, desativa a conta e a remove das listagens. Os dados permanecem no banco para auditoria/conformidade. O correlationId fica queimado — recriar com o mesmo correlationId retorna 409 SUBACCOUNT_DELETED.

Pré-condições (todas verificadas dentro de transação Serializable — TOCTOU-safe)

A exclusão é bloqueada (fail-closed) se a subconta tiver qualquer pendência financeira:

Saldo não zerado (available, reserved ou pending ≠ 0).

Cobrança ACTIVE.

Disputa/MED em aberto (qualquer status não-terminal).

Saque em processamento (qualquer status não-terminal).

Path param

Param	Descrição
`id`	ID da subconta (`{{subaccount_id}}`).

Resposta

200 OK com { success: true, message: "Subconta excluída (soft delete)" }.

Erros

HTTP	code	Quando
401	—	API key ausente/inválida.
403	—	Escopo `subaccounts:write` ausente.
404	—	Sem a flag, subconta inexistente/de outro master.
409	—	Subconta já excluída.
422	`SUBACCOUNT_DELETE_BLOCKED`	Saldo, cobrança ativa, disputa aberta ou saque em processamento impedem a exclusão.

Exemplo cURL

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Excluir subconta (soft delete)

Autenticação

Excluir subconta (soft delete)

Pré-condições (todas verificadas dentro de transação Serializable — TOCTOU-safe)

Path param

Resposta

Erros

Exemplo cURL

Requisição

Respostas

Excluir subconta (soft delete)

Autenticação#

Excluir subconta (soft delete)#

Pré-condições (todas verificadas dentro de transação Serializable — TOCTOU-safe)#

Path param#

Resposta#

Erros#

Exemplo cURL#

Requisição

Respostas

Autenticação

Excluir subconta (soft delete)

Pré-condições (todas verificadas dentro de transação Serializable — TOCTOU-safe)

Path param

Resposta

Erros

Exemplo cURL