Subscription Interval vs Subscription Item Interval

In our platform you can find both Subscription IntervalClosed A subscription interval is the time period after which a recurring purchase is renewed and billed. The time period can be set in days, months, or years. One subscription can contain x products, all renewing on the same date. Number and Subscription ItemClosed A subscription item is component of a subscription with its own set of attributes including price, description and feature set. Interval Number. Both have a distinct definition:

Subscription Interval Number

Every newly created subscription gets an interval number assigned to it. The initial subscription purchaseClosed An order made by a customer and the records associated with it., or sign-up, is equivalent to interval 0. With every subsequent renewal of the subscription, the subscription interval number is incremented by 1. Interval 1 is equivalent to the first subscription renewal, interval 2 to the second subscription renewal, and so on.

Every subscription can contain x subscription items, which all renew on the same date.

Example

If a customerClosed An individual or business purchasing your product or service by placing an order through Cleverbridge. The customer is the end user of this product, as they are not allowed to resell the purchased products or services. ​ A customer is unique per client. If a customer purchases products or services from two different clients, there are 2 separate records of said customer.​ has more than one ongoing subscription, each subscription is set to renew on its own individual date, depending on the initial date of the subscription purchase and the subscription length: Subscription 1 renews on January 3; subscription 2 renews on July 19, etc. The renewal of multiple items within each individual subscription, however, is set to renew on the same date.

Subscription Item Interval Number

Every newly created subscription item gets an interval number assigned to it. The initial subscription item purchase is equivalent to interval 0. With every subsequent renewal of the subscription item, the subscription item interval number is incremented by 1. Interval 1 is equivalent to the first subscription item renewal, interval 2 to the second subscription item renewal, and so on.

All subscription items in one subscription (Subscription 1) have the same renewal date: January 3.

Example

Click on the image below to zoom in. At the bottom you can see the running Subscription Interval Number. In the rows above, you can see the respective running Item Interval Numbers.

Use Cases

Subscriptions with one single subscription item

Provided the subscription item remains the same and has not been replaced by another subscription item throughout the duration of the subscription, reporting on subscription interval number and subscription item interval number will come back with identical results.

Subscriptions with multiple subscription items

When reporting on the subscription level, any addition of items is counted as a single renewal.

When reporting on subscription item level, additional item(s) are counted as purchase (item interval 0) and existing items are counted as renewals. This leads to more events being reported: e.g. 1 renewal + 1 purchase in a 2-item subscription.

Note

  • In XML, Subscription Interval Number and Subscription Item Interval Number are called SubscriptionIntervalNo and IntervalNo, respectively.
  • In JSON, Subscription Interval Number and Subscription Item Interval Number are called subscriptionIntervalNumber and intervalNumber, respectively.