> ## 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.

# Excluir uma conta para saques

> Desconecta uma conta para saques da organização atuante.

Desconecta uma `payout_account` da organização atuante. O destino de repasses
continua preservado no cadastro financeiro; esta operação apenas remove o
vínculo que permite que a organização veja e use essa conta para saques.

## Autenticação

| Credencial             | Acesso                                                   |
| ---------------------- | -------------------------------------------------------- |
| 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 para saques (`pa_*`).
</ParamField>

<RequestExample>
  ```bash cURL theme={"theme":"css-variables"}
  curl -X DELETE "https://api.chargefy.io/v1/payout-accounts/pa_d6HV5h2XK8KDWLGR" \
    -H "Authorization: Bearer {{API_KEY}}" \
    -H "Organization: org_jSTwXizF3Ff6BtES"
  ```
</RequestExample>

## Resposta

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

<ResponseExample>
  ```json 200 theme={"theme":"css-variables"}
  {
    "id": "pa_d6HV5h2XK8KDWLGR",
    "object": "payout_account",
    "deleted": true
  }
  ```
</ResponseExample>

## Webhooks

Desconexão bem-sucedida emite `payout.account.detached` com a `payout_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.payout_account`.

## Erros

| Status | `code`                  | Quando                                                                  |
| ------ | ----------------------- | ----------------------------------------------------------------------- |
| `400`  | `invalid_request`       | ID ausente.                                                             |
| `401`  | `authentication_failed` | API key ausente, inválida, revogada ou expirada.                        |
| `403`  | `permission_denied`     | API key sem acesso à organização ou sem escopo suficiente.              |
| `404`  | `resource_missing`      | Conta para saques inexistente ou fora do escopo da organização atuante. |
| `409`  | `sandbox_unsupported`   | Contas para saques ainda não são suportadas no sandbox.                 |
| `500`  | `internal_error`        | Erro temporário desconectando a conta para saques. Faça retry.          |