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

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

string

required

ID do cliente (cus_*).

curl -X DELETE "https://api.chargefy.io/v1/customers/cus_1RdBn39CN1euYoye" \
  -H "Authorization: Bearer {{API_KEY}}"

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`

{
  "id": "cus_1RdBn39CN1euYoye",
  "object": "customer",
  "deleted": true
}

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.

Fundamentos da API

Objetos de sistema

Webhooks e eventos

SDKs

MCP

Excluir um cliente

Autenticação

Parâmetros de caminho

Resposta

Erros comuns

Webhook

​Autenticação

​Parâmetros de caminho

​Resposta

​Erros comuns

​Webhook

Autenticação

Parâmetros de caminho

Resposta

Erros comuns

Webhook