Excluir subconta

Devolve o saldo à conta principal, tira a subconta da API e libera o externalId.

DELETE /v1/subaccounts/{id}

cURL

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

200

{ "deleted": true, "id": "sacc_9f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f", "externalId": "vendedor-42", "name": "Ateliê da Ana", "returned": 3000 }

Escopo subaccounts:write. Não tem volta. O saldo que estiver nela volta para a sua conta principal (um movimento return), a subconta some das listas e das rotas (404 depois) e o externalId fica livre para outra. O extrato dela continua guardado e as cobranças já feitas não mudam; cobrança ligada a ela que for paga depois fica com você.

Para parar só por um tempo, use Editar subconta com active: false.

id · string · required

sacc_ + 32 hex ou o seu externalId. Com saque dela em andamento: 409 SUBACCOUNT_BUSY (um saque que falhar precisa da subconta para devolver o valor); espere concluir.

​

Resposta

deleted · boolean

true.

id · string

A subconta excluída.

externalId · string | null

O externalId que ela tinha (agora livre).

name · string

Nome.

returned · integer

Quanto voltou para a sua conta principal, em centavos.

cURL

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

200

{ "deleted": true, "id": "sacc_9f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f", "externalId": "vendedor-42", "name": "Ateliê da Ana", "returned": 3000 }