---
title: "Cancel a subscription (terminal, no refund/proration)"
method: POST
path: "/subscriptions/{id}/cancel"
tags: ["Subscriptions"]
---

# Cancel a subscription (terminal, no refund/proration)

`POST /subscriptions/{id}/cancel`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `ApiKey`, `MerchantId`, `Environment`

## Path parameters

- `id` number, required

## Headers

- `ApiKey` string, required
- `MerchantId` string, required
- `Environment` 'live' | 'sandbox', required

## Response `200`

- SubscriptionResponseDto
  - `id` number, required: Subscription identifier — pass this into the cancel/suspend/charge/transactions endpoints.
  - `cybersourceSubscriptionId` object, nullable, required: Same value received as `subscriptionId` in the `subscription.created` webhook payload. Null for a merchant_initiated subscription — there is no RBS-side subscription.
  - `status` 'created' | 'pending' | 'active' | 'delinquent' | 'suspended' | 'cancelled' | 'completed', required
  - `billingMode` 'rbs_scheduled' | 'merchant_initiated', required: rbs_scheduled — debited on a schedule by Cybersource RBS; merchant_initiated — charged on demand via POST /subscriptions/{id}/charge.
  - `frequency` 'weekly' | 'monthly', nullable, required: Null for a merchant_initiated subscription — charges are on-demand, not scheduled.
  - `amount` object, nullable, required: Null for a merchant_initiated subscription — charge amounts are per-call, not fixed.
  - `currency` string, required
  - `startDate` object, nullable, required: Null for a merchant_initiated subscription.
  - `customerId` string, required
  - `createdAt` string, date-time, required

## Other responses

- `401`: Wrong credentials
- `403`: Forbidden
- `404`: Not Found
- `409`: Invalid request
- `500`: Internal error
- `503`: Service unavailable

## Changes

- **2026-11-03** `f6d3f87df5e0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hub2/apis/hub2-service-api/changes/subscriptions/:id/cancel/post.md)

---

[API](https://skmtc.dev/hub2/apis/hub2-service-api.md) - [All operations](https://skmtc.dev/hub2/apis/hub2-service-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hub2/apis/hub2-service-api/revisions/f6d3f87df5e0?raw)