---
title: "Cancel Subscription"
method: PATCH
path: "/subscription/api/v1/subscriptions/{id}/cancel"
tags: ["Subscription Lifecycle"]
---

# Cancel Subscription

`PATCH /subscription/api/v1/subscriptions/{id}/cancel`

This endpoint permanently cancels a subscription. Once cancelled, no further recurring charges will be attempted. 

**Note:**

- Cancelling a subscription is a **terminal action**. Once cancelled, future billing stops immediately and `nextChargeDate` is cleared.

## Path parameters

- `id` string, required

## Request body

- CancelSubscriptionRequest
  - `reason` string, required — The reason for cancelling this subscription.

## Response `200`

Request Successful

- CancelSubscriptionResponse
  - `success` boolean — Indicates if the request was successful.
  - `message` string — Descriptive message confirming the cancellation operation.
  - `data` object — The payload containing the deactivated subscription details.
    - `id` integer — Unique internal identifier for the subscription.
    - `customerId` string — Unique reference identifier assigned to the customer layer.
    - `customerEmail` string, email — The email address of the customer whose subscription was cancelled.
    - `status` string — The updated lifecycle state of the subscription, which is now **CANCELLED**.
    - `enrollmentReference` string — The global token signature identifying the authorized card reference.
    - `enrollmentTxnReference` string — Transaction baseline reference tracking the original enrollment event.
    - `cancelledAt` string, date-time — Timestamp indicating exactly when the subscription was transitioned to the cancelled state.
    - `cancellationReason` string — The categorized explanation or code indicating why the subscription was terminated.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/versions/1ecd4b94ff07/schema)