Skip to main content
POST
/
subscription
/
{id}
/
cancel
cancel subscription at period end
curl --request POST \
  --url https://uat-api.clinkbill.com/api/subscription/{id}/cancel \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --header 'X-Timestamp: <api-key>' \
  --data '
{
  "reason": "<string>"
}
'
{
  "code": 123,
  "msg": "<string>",
  "data": {
    "subscriptionId": "<string>",
    "customerId": "<string>",
    "productId": "<string>",
    "priceId": "<string>",
    "priceSnapshotId": "<string>",
    "createTime": 123,
    "quantity": 123,
    "paymentMethodType": "<string>",
    "paymentInstrumentId": "<string>",
    "status": "<string>",
    "billing": "<string>",
    "recurringInvoiceItem": {
      "invoiceItemId": "<string>",
      "amount": 123,
      "discountAmount": 123,
      "paymentAmount": 123,
      "couponTerms": "<string>",
      "promotionCode": "<string>",
      "periodStart": 123,
      "periodEnd": 123,
      "proration": true,
      "price": {
        "productId": "<string>",
        "productName": "<string>",
        "priceId": "<string>",
        "priceSnapshotId": "<string>",
        "unitAmount": 123,
        "quantity": 123,
        "recurring": {
          "trialPeriodDays": 123
        }
      }
    },
    "merchantReference": "<string>",
    "sessionId": "<string>",
    "trialStart": 123,
    "trialEnd": 123,
    "currentPeriodStart": 123,
    "currentPeriodEnd": 123,
    "cancelAt": 123,
    "cancelAtPeriodEnd": true,
    "canceledAt": 123,
    "cancelReason": "<string>",
    "upcomingInvoiceItem": {
      "invoiceItemId": "<string>",
      "amount": 123,
      "discountAmount": 123,
      "paymentAmount": 123,
      "couponTerms": "<string>",
      "promotionCode": "<string>",
      "periodStart": 123,
      "periodEnd": 123,
      "proration": true,
      "price": {
        "productId": "<string>",
        "productName": "<string>",
        "priceId": "<string>",
        "priceSnapshotId": "<string>",
        "unitAmount": 123,
        "quantity": 123,
        "recurring": {
          "trialPeriodDays": 123
        }
      }
    },
    "metadata": {}
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.clinkbill.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

X-API-KEY
string
header
required

Your secret API key obtained from the Clink dashboard (Developers section)

X-Timestamp
string
header
required

Current timestamp in milliseconds since Unix epoch (required for request signing)

Path Parameters

id
string
required

Unique identifier of the subscription

Body

application/json

cancel request

reason
string
required
Required string length: 1 - 255
cancelReasonCode
enum<string>

Allowed cancel reason codes

Available options:
too_expensive,
need_more_features,
found_alternative,
no_longer_needed,
poor_customer_service,
poor_usability,
poor_quality,
other_reasons

Response

updated subscription

code
integer<int32>
msg
string
data
object