Welcome to Zuora Product Documentation

Explore our rich library of product information

Cancel a prepayment subscription - REST API

Learn how to use the REST API to cancel a prepayment subscription.

Use the Create an order operation to cancel a subscription.

Sample request body: Cancel an existing subscription with the cancellation effective date on 2022-05-01.

Sample REST API request to cancel a prepayment subscription

Request: POST /v1/orders

Request Body:
"subscriptions": [
    {
      "subscriptionNumber": "$SubscriptionNum",
      "orderActions": [
        {
          "type": "CancelSubscription",
          "triggerDates": [
            {
              "name": "ContractEffective",
              "triggerDate": "2022-03-15"
            },
            {
              "name": "ServiceActivation",
              "triggerDate": "2022-03-15"
            },
            {
              "name": "CustomerAcceptance",
              "triggerDate": "2022-03-15"
            }
          ],
          "cancelSubscription": {
            "cancellationPolicy": "SpecificDate",
            "cancellationEffectiveDate": "2022-05-01"
          }
        }
      ]
    }
  ],

Once the order action is activated, your customer's subscription will be canceled on 2022-05-01.

You can view the customer's prepaid balance through the Zuora UI or Data Query.