# Cancelar Assinatura
`DELETE /v1/subscriptions/:subscriptionId`
**Área:** Assinaturas

**Scopes necessários:** `subscriptions/write`

Cancela uma assinatura ativa, interrompendo todas as cobranças futuras. **Rota recomendada** para cancelamento (preferir em relação ao PATCH com `action: "cancel"`).

A assinatura é marcada como `CANCELED` imediatamente. Ciclos futuros pendentes (`PENDING`, `AWAITING_PAYMENT`) são cancelados.

O campo `reason` é opcional e pode ser usado para registrar o motivo do cancelamento.

Case de uso:

_Como SaaS, quero cancelar a assinatura de um cliente que solicitou encerramento do serviço._

### Path parameters

| Campo | Obrigatório | Descrição |
|---|---|---|
| `subscriptionId` | **sim** | ID da assinatura (ex: sub_xxx) - required |

### Request body

```json
{
  "reason": "Cliente solicitou"
}
```

### Campos do body

**Opcionais**

| Campo | Descrição |
|---|---|
| `reason` | Motivo do cancelamento |

### Resposta 200 — 200

```json
{
  "success": true,
  "message": "Assinatura cancelada com sucesso",
  "status": "CANCELED",
  "canceledCycles": 2
}
```

### Resposta 400 — 400

```json
{
    "error": {
        "message": "Assinatura já está cancelada",
        "code": "SUBSCRIPTION_ALREADY_CANCELED",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

### Resposta 404 — 404

```json
{
    "error": {
        "message": "Assinatura não encontrada",
        "code": "SUBSCRIPTION_NOT_FOUND",
        "details": null,
        "timestamp": "2026-07-14T21:39:36.322Z"
    }
}
```

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