# Remover Cliente
`DELETE /v1/customers/:customerId`
**Área:** Clientes

**Scopes necessários:** `customers/delete`

Remove um cliente da sua conta.

A exclusão é bloqueada quando o cliente possui assinaturas recorrentes vinculadas, retornando erro 400 (CUSTOMER_HAS_ACTIVE_SUBSCRIPTIONS). Cancele as assinaturas antes de excluir.

Case de uso:

_Como plataforma, quero remover um cadastro criado por engano, garantindo que clientes com assinaturas ativas não sejam apagados por acidente._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `customerId` | **sim** | Customerid |

### Resposta 200 — 200

```json
{
  "success": true
}
```

### Resposta 400 — 400

```json
{
    "error": {
        "message": "Cliente possui assinaturas vinculadas e não pode ser excluído",
        "code": "CUSTOMER_HAS_ACTIVE_SUBSCRIPTIONS",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

---
Página: https://docs.validapay.com.br/documentacao-validapay2/delete-remover-cliente
Contrato OpenAPI: https://docs.validapay.com.br/openapi.json