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

# Delete a Bank Account

> Desconecta uma conta bancária da organização atuante.

Desconecta uma `bank_account` da organização atuante. A credencial bancária
continua preservada no cadastro financeiro; esta operação apenas remove o
vínculo que permite que a organização veja e use essa conta.

## Autenticação

| Credencial             | Acesso                                                   |
| ---------------------- | -------------------------------------------------------- |
| JWT de usuário         | Requer acesso à organização.                             |
| API key da organização | Requer escopo `write` ou `admin`.                        |
| API key da plataforma  | Organização conectada indicada no header `Organization`. |

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  ID da conta bancária (`ba_*`).
</ParamField>

<RequestExample>
  ```bash cURL theme={}
  curl -X DELETE "https://api.chargefy.io/v1/bank-accounts/ba_123" \
    -H "Authorization: Bearer {{API_KEY}}" \
    -H "Organization: org_789"
  ```
</RequestExample>

## Resposta

`200 OK` com confirmação de desconexão.

<ResponseExample>
  ```json 200 theme={}
  {
    "id": "ba_123",
    "object": "bank_account",
    "deleted": true
  }
  ```
</ResponseExample>

## Webhooks

Desconexão bem-sucedida emite `bank.account.detached` com a `bank_account`
completa como estava imediatamente antes da desconexão. Quando a conta
conectada da organização muda, também emite `organization.updated` com
`data.previous_attributes.bank_account`.

## Erros

| Status | Quando                                                               |
| ------ | -------------------------------------------------------------------- |
| `400`  | ID ausente.                                                          |
| `401`  | Credencial ausente, inválida, revogada ou expirada.                  |
| `403`  | Credencial sem acesso à organização ou sem escopo suficiente.        |
| `404`  | Conta bancária inexistente ou fora do escopo da organização atuante. |
| `409`  | Contas bancárias ainda não são suportadas no sandbox.                |
| `500`  | Erro temporário desconectando a conta bancária. Faça retry.          |