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

> Remove ou desativa um cliente.

Remove um `customer` da organização. A Chargefy preserva histórico financeiro
internamente (transações, assinaturas, invoices passadas), mas o cliente some
das listagens e não pode mais ser consultado por
[`GET /v1/customers/:id`](/api-reference/customers/get).

## Autenticação

A API key da própria organização atua diretamente. A API key de plataforma exige o
header `Organization: <organization_id>` apontando para uma organização
conectada ativa.

## Parâmetros de caminho

<ParamField path="id" type="string" required>
  ID do cliente (`cus_*`).
</ParamField>

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

## Resposta

`200 OK` com o objeto curto de remoção.

| Campo     | Tipo      | Observação             |
| --------- | --------- | ---------------------- |
| `id`      | `string`  | ID do cliente removido |
| `object`  | `string`  | Sempre `"customer"`    |
| `deleted` | `boolean` | Sempre `true`          |

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

## Erros comuns

| Status | `code`             | Quando ocorre                                             |
| ------ | ------------------ | --------------------------------------------------------- |
| `404`  | `resource_missing` | Cliente não existe nesta organização (ou já foi removido) |

## Webhook

A remoção dispara `customer.deleted` com o `customer` em `data.object` no
estado imediatamente anterior à remoção.