> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wyzecash.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Excluir subconta

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

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](https://docs.wyzecash.com.br/referencia/subcontas/editar-subconta.md) 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.

```bash cURL theme={null}
curl -X DELETE https://api.wyzecash.com.br/v1/subaccounts/vendedor-42 \
  -H "Authorization: Bearer bk_live_..."
```

```json 200 theme={null}
{ "deleted": true, "id": "sacc_9f1c2d3e4a5b6c7d8e9f0a1b2c3d4e5f", "externalId": "vendedor-42", "name": "Ateliê da Ana", "returned": 3000 }
```

```json 409 theme={null}
{
  "error": { "code": "SUBACCOUNT_BUSY", "message": "Essa subconta tem um saque em andamento. Espere concluir para excluir." },
  "requestId": "req_01JA..."
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.