Renew an Automatically Renewing Subscription Early

Overview

This guide explains how to use the Get Subscription and Renew Subscription API endpoints to renew a subscription before the end of its billing period.

Use case

  1. The customer decides to renew their subscription ahead of the end of the billing period.
  2. On the Self-Service page, the customer clicks Renew, which uses the Get Subscription endpoint to obtain and display the price, new expiration date, and other details.
  3. After reviewing this information, the customer clicks the Buy Now button to confirm the purchase. The page uses the Renew Subscription endpoint to renew the subscription ahead of the end of the billing period.

Implement API Endpoints

Before you start

🚧

Important

Get the customer's consent before making changes to a subscription.

To avoid chargebacks and customer inquiries, it is also essential that you coordinate all price increases with Client Experience.

In the European Economic Area (EEA), Strong Customer Authentication (SCA) is required for recurring electronic payments when the amount changes. This means that some of your customers will have to authenticate their payment, which in turn might impact the renewal success rate.

For more information, see Best Practices: Obtain Customer Consent.

Make sure that:

  • The subscription has the Automatic renewal type, which does not require the customer to initiate the renewal at the end of the billing interval.
  • The current billing interval has started and the next billing date has not been reached yet.
  • The renewal is not combined with an alignment of the subscription. For more information, see Get Started with Subscriptions > Alignment Settings.
  • The call using the Renew Subscription API endpoint must be made between the start of the current billing interval and the next billing date.
  • By default, the Cleverbridge platform bills the customer the full price for the next billing interval, which starts immediately. Any remaining time from the current billing interval is added to the next billing interval, moving the next billing date further into the future. If you want to suppress this behavior, set ResetBillingInterval to true.

Step 1: Preview price and new expiration date

Call the Get Subscription API endpoint to preview the price and new expiration date.

The parameter listed in the table does the following:

  • Calculate the next billing date if the renewal is made
  • Return the next billing date in the NextBillingDate parameter of the API response (so that it can be provided to the customer)
  • Do not change any data in the Cleverbridge system

Parameters

ParameterTypeRequiredExampleNotes
SubscriptionIdstrYesS67661151The unique identifier of the subscription.

Request

curl --location 'https://rest.cleverbridge.com/subscription/getsubscription?subscriptionId=S67661151' 
--header 'Accept: application/json' 
--header 'Authorization: Basic YOUR_BASE64_ENCODED_CREDENTIALS'
import http.client

conn = http.client.HTTPSConnection("rest.cleverbridge.com")
payload = ''
headers = {
  'Accept': 'application/json',
  'Authorization': 'Basic YOUR_BASE64_ENCODED_CREDENTIALS',
}
conn.request("GET", "/subscription/getsubscription?subscriptionId=S67661151", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
var https = require('follow-redirects').https;
var fs = require('fs');

var options = {
  'method': 'GET',
  'hostname': 'rest.cleverbridge.com',
  'path': '/subscription/getsubscription?subscriptionId=S67661151',
  'headers': {
    'Accept': 'application/json',
    'Authorization': 'Basic YOUR_BASE64_ENCODED_CREDENTIALS'
  },
  'maxRedirects': 20
};

var req = https.request(options, function (res) {
  var chunks = [];

  res.on("data", function (chunk) {
    chunks.push(chunk);
  });

  res.on("end", function (chunk) {
    var body = Buffer.concat(chunks);
    console.log(body.toString());
  });

  res.on("error", function (error) {
    console.error(error);
  });
});

req.end();
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.get("https://rest.cleverbridge.com/subscription/getsubscription?subscriptionId=S67661151")
  .header("Accept", "application/json")
  .header("Authorization", "Basic YOUR_BASE64_ENCODED_CREDENTIALS")
  .asString();

Response

{
    "Subscription": {
        "CustomerCurrencyId": "USD",
        "CustomerId": 157824676,
        "CustomerReferenceId": "uEd5Jq3yOMs1NkEh8bV7nu9zJZJAUe2vyYxnVgL8",
        "CustomerReferenceNo": "",
        "EndDate": null,
        "GracePeriodDays": 0,
        "Id": 67661151,
        "IntervalDayCount": 0,
        "IntervalMonthCount": 1,
        "BillingIntervalDayCount": 0,
        "BillingIntervalMonthCount": 0,
        "Items": [
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 10,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 1,
                "VersionActiveDate": "2026-02-18T16:59:11.003593"
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 2,
                "VersionActiveDate": null
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 3,
                "VersionActiveDate": null
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 4,
                "VersionActiveDate": null
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": true,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": "USD",
                "NextBillingCustomerGrossPrice": 75.0,
                "NextBillingCustomerNetPrice": 63.03,
                "NextBillingCustomerVatPrice": 11.97,
                "NextRenewalCustomerGrossPrice": 75.0,
                "NextRenewalCustomerNetPrice": 63.03,
                "NextRenewalCustomerVatPrice": 11.97,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 5,
                "VersionActiveDate": "2026-03-11T13:39:43.236774"
            }
        ],
        "LastIntervalNo": 3,
        "LastBillingIntervalNo": 0,
        "NextBillingCurrencyId": "USD",
        "NextBillingCustomerGrossPrice": 75.0,
        "NextBillingCustomerNetPrice": 63.03,
        "NextBillingCustomerVatPrice": 11.97,
        "NextRenewalCustomerGrossPrice": 75.0,
        "NextRenewalCustomerNetPrice": 63.03,
        "NextRenewalCustomerVatPrice": 11.97,
        "NextBillingDate": "2026-04-13T09:43:08.734828",
        "NextRenewalDate": "2026-04-13T09:43:08.734828",
        "NextBillingDateReminder": "2026-04-11T09:43:08.734828Z",
        "PaymentInfo": {
            "CardExpirationDate": {
                "Month": 12,
                "Year": 2027
            },
            "CardLastFourDigits": "765T",
            "Currency": null,
            "CurrencyId": null,
            "IsPurchaseOrder": null,
            "PaymentType": "Visa",
            "PaymentTypeId": "CCA_VIS"
        },
        "RenewalType": "Automatic",
        "StartDate": "2026-02-18T16:59:11.003593",
        "StartIntervalDayCount": 0,
        "StartIntervalMonthCount": 1,
        "Subscriptionstatus": 1,
        "ManagementModel": "One",
        "SelfServiceUrl": "https://www.cleverbridge.com/864/s/s67661151-yRpzOYTr1cDep5hX"
    },
    "ResultMessage": "OK"
}

Step 2: Renew subscription for another billing interval

In the second API call, use the Renew Subscription API endpoint and the parameters listed in the table to update the customer's subscription data in the Cleverbridge platform.

ParameterTypeRequiredExampleNotes
SubscriptionIdstrYesS67661151The unique identifier of the subscription.
ResetBillingIntervalboolYesfalseSet to true to immediately start the new billing interval
📘

Note

The UpdateAction parameter is currently used for documentation and tracking only. The value set does not affect transaction processing.

The supported values are as follows:

  • For upgrades, set the parameter to upgrade(or 1 for JSON)
  • For downgrades, set the parameter to downgrade, (or 2 for JSON)
  • For all other changes, set the parameter to update (or 0 for JSON)

Request

curl --location 'https://rest.cleverbridge.com/subscription/renewsubscription' 
--header 'Content-Type: application/json' 
--header 'Accept: application/json' 
--header 'Authorization: Basic YOUR_BASE64_ENCODED_CREDENTIALS' 
--data '{
    "SubscriptionId": "S67661151",
    "ResetBillingInterval": false
}'
import http.client
import json

conn = http.client.HTTPSConnection("rest.cleverbridge.com")
payload = json.dumps({
  "SubscriptionId": "S67661151",
  "ResetBillingInterval": False
})
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'Authorization': 'Basic YOUR_BASE64_ENCODED_CREDENTIALS',
}
conn.request("POST", "/subscription/renewsubscription", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
var request = require('request');
var options = {
  'method': 'POST',
  'url': 'https://rest.cleverbridge.com/subscription/renewsubscription',
  'headers': {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Basic YOUR_BASE64_ENCODED_CREDENTIALS'
  },
  body: JSON.stringify({
    "SubscriptionId": "S67661151",
    "ResetBillingInterval": false
  })

};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});
Unirest.setTimeouts(0, 0);
HttpResponse<String> response = Unirest.post("https://rest.cleverbridge.com/subscription/renewsubscription")
  .header("Content-Type", "application/json")
  .header("Accept", "application/json")
  .header("Authorization", "Basic YOUR_BASE64_ENCODED_CREDENTIALS")
  .body("{\n    \"SubscriptionId\": \"S67661151\",\n    \"ResetBillingInterval\": false\n}")
  .asString();

Response

{
    "Subscription": {
        "CustomerCurrencyId": "USD",
        "CustomerId": 157824676,
        "CustomerReferenceId": "uEd5Jq3yOMs1NkEh8bV7nu9zJZJAUe2vyYxnVgL8",
        "CustomerReferenceNo": "",
        "EndDate": null,
        "GracePeriodDays": 0,
        "Id": 67661151,
        "IntervalDayCount": 0,
        "IntervalMonthCount": 1,
        "BillingIntervalDayCount": 0,
        "BillingIntervalMonthCount": 0,
        "Items": [
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 10,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 1,
                "VersionActiveDate": "2026-02-18T16:59:11.003593"
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 2,
                "VersionActiveDate": null
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 3,
                "VersionActiveDate": null
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": false,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": null,
                "NextBillingCustomerGrossPrice": null,
                "NextBillingCustomerNetPrice": null,
                "NextBillingCustomerVatPrice": null,
                "NextRenewalCustomerGrossPrice": null,
                "NextRenewalCustomerNetPrice": null,
                "NextRenewalCustomerVatPrice": null,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 4,
                "VersionActiveDate": null
            },
            {
                "Couponcode": "",
                "DeactivationDate": null,
                "EndDate": null,
                "IsCurrent": true,
                "LastIntervalNo": 3,
                "NextBillingCurrencyId": "USD",
                "NextBillingCustomerGrossPrice": 75.0,
                "NextBillingCustomerNetPrice": 63.03,
                "NextBillingCustomerVatPrice": 11.97,
                "NextRenewalCustomerGrossPrice": 75.0,
                "NextRenewalCustomerNetPrice": 63.03,
                "NextRenewalCustomerVatPrice": 11.97,
                "ProductId": 292973,
                "ProductName": "Cloudify Seat",
                "ProductNameExtension": "",
                "PromotionId": null,
                "Quantity": 15,
                "RecurrenceCount": null,
                "RunningNo": 1,
                "StartDate": "2026-02-18T16:59:11.003593",
                "Status": 1,
                "SubscriptionId": 67661151,
                "SubscriptionPurchaseItems": [
                    {
                        "PurchaseId": 532209743,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 0,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595140,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 1,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534794706,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 3,
                        "BillingIntervalNo": 0
                    },
                    {
                        "PurchaseId": 534595860,
                        "PurchaseItemRunningNo": 1,
                        "SubscriptionIntervalNo": 2,
                        "BillingIntervalNo": 0
                    }
                ],
                "Version": 5,
                "VersionActiveDate": "2026-03-11T13:39:43.236774"
            }
        ],
        "LastIntervalNo": 3,
        "LastBillingIntervalNo": 0,
        "NextBillingCurrencyId": "USD",
        "NextBillingCustomerGrossPrice": 75.0,
        "NextBillingCustomerNetPrice": 63.03,
        "NextBillingCustomerVatPrice": 11.97,
        "NextRenewalCustomerGrossPrice": 75.0,
        "NextRenewalCustomerNetPrice": 63.03,
        "NextRenewalCustomerVatPrice": 11.97,
        "NextBillingDate": "2026-04-13T09:43:08.734828",
        "NextRenewalDate": "2026-04-13T09:43:08.734828",
        "NextBillingDateReminder": "2026-04-11T09:43:08.734828Z",
        "PaymentInfo": {
            "CardExpirationDate": {
                "Month": 12,
                "Year": 2027
            },
            "CardLastFourDigits": "765T",
            "Currency": null,
            "CurrencyId": null,
            "IsPurchaseOrder": null,
            "PaymentType": "Visa",
            "PaymentTypeId": "CCA_VIS"
        },
        "RenewalType": "Automatic",
        "StartDate": "2026-02-18T16:59:11.003593",
        "StartIntervalDayCount": 0,
        "StartIntervalMonthCount": 1,
        "Subscriptionstatus": 1,
        "ManagementModel": "One",
        "SelfServiceUrl": "https://www.cleverbridge.com/864/s/s67661151-yRpzOYTr1cDep5hX"
    },
    "ResultMessage": "OK"
}

Diagram

flowchart LR
  classDef mainColor fill:#ffffff,color:#555555,stroke:#96C34B,stroke-width:2px;

  A(["&nbsp;&nbsp;<br/>The customer decides to renew their subscription ahead of the end of the billing period&nbsp;&nbsp;<br/>&nbsp;"]):::mainColor
    --> B(["&nbsp;&nbsp;<br/><i>Update Subscription Item</i> endpoint is used to obtain and display the price, new expiration date, and other details&nbsp;&nbsp;<br/>&nbsp;"]):::mainColor
    --> C(["&nbsp;&nbsp;<br/><i>Renew Subscription</i> endpoint is used after the customer confirms the purchase and clicks the <b>Buy Now</b> button&nbsp;&nbsp;<br/>&nbsp;"]):::mainColor