Subscription Model

This top-level JSON object is used for notifications related to subscriptions, such as renewals, billing changes, pricing updates, and subscription lifecycle events.

Field NameTypeDescription
metaobjectMetadata related to the notification. For more information, see Meta Object.
subscriptionIdintegerUnique ID of the subscription.
customerCurrencyIdstringID of the customer’s currency (e.g., USD, EUR).
customerIdintegerUnique ID of the customer.
customerReferenceIdstringInternal customer reference ID.
customerReferenceNostringYour unique ID for the customer. This value is submitted by you when the customer initially purchases a product and is stored by Cleverbridge. Corresponds to the Internal customer ID in the Commerce Assistant. It can be used to identify the customer and auto-process the order. For more information, see Internal Customer Data.
gracePeriodDaysintegerThe number of days in which the customer can use the product during a grace period.
billingIntervalDayCountintegerNumber of days in the billing interval.
billingIntervalMonthCountintegerNumber of months in the billing interval.
intervalDayCountintegerNumber of days in the general interval.
intervalMonthCountintegerNumber of months in the general interval.
lastBillingIntervalNumberintegerNumber of the last billed interval of the subscription. Counting starts at 0. For each successfully paid interval, the number is increased by one.
lastIntervalNumberintegerNumber of the last successfully paid interval of the subscription. Counting starts at 0. For each successfully paid interval, the number is increased by one.
nextBillingDatestringNext billing date according to RFC3339 . Specified in UTC.
nextRenewalDatestringNext expected renewal date according to RFC3339.
nextBillingDateReminderstringReminder date prior to next billing according to RFC3339.
startDatestringSubscription start date according to RFC3339.
endDatestringSubscription end date according to RFC3339 .
managementModelstringModel used to manage subscription (e.g., self-managed, assisted).
renewalTypestringType of renewal applied (e.g., manual, auto).
startIntervalDayCountintegerStart interval in days.
startIntervalMonthCountintegerStart interval in months.
subscriptionStatusstringCurrent status of the subscription.
cartCouponCodestringCoupon code applied to the cart for a promotion.
cartPromotionIdintegerID of the promotion to which the coupon code belongs.
cartPromotionNamestringName of the promotion to which the coupon code belongs.
packageDiscountIdintegerID of the package discount applied.
packageDiscountNamestringThe name of the package discount applied.
packagePriceConfigurationIdintegerID of the package pricing configuration.
packagePriceConfigurationNamestringName of the package pricing configuration.
yourRenewalPriceobjectRenewal pricing information that your company set up in the Cleverbridge platform for this subscription. For more information, see Price Object.
customerRenewalPriceobjectRenewal pricing information that the customer receives during the purchase process for this subscription. For more information, see Price Object .
subscriptionPurchaseobjectBasic purchase details linked to this subscription. For more information, see SubscriptionPurchase Object.
subscriptionItemsarray of objectsList of current Subscription Item Objects .
previousSubscriptionItemsarray of objectsList of previously active Subscription Item Objects .