Skip to main content
curl -X DELETE "https://api.chargefy.io/v1/customers/cus_123" \
  -H "Authorization: Bearer {{API_KEY}}"

{
  "id": "cus_123",
  "object": "customer",
  "deleted": true
}
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

​
id
string
required
ID do cliente (cus_*).
curl -X DELETE "https://api.chargefy.io/v1/customers/cus_123" \
  -H "Authorization: Bearer {{API_KEY}}"

​
Resposta

200 OK com o objeto curto de remoção.
CampoTipoObservação
idstringID do cliente removido
objectstringSempre "customer"
deletedbooleanSempre true
{
  "id": "cus_123",
  "object": "customer",
  "deleted": true
}

​
Erros comuns

StatuscodeQuando ocorre
404resource_missingCliente 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.