Subscription models
The subscription model object and the allowed CRUD operations on the related resource endpoint
A subscription model determines how automatic order subscriptions using recurring order copies are generated for the associated market. The subscription model defines which are the subscription frequencies available in that market. Those available frequencies can be specified for the orders' line items. Based on the line items that have a frequency, the necessary order subscriptions are generated, according to the specified subscription strategy.
To set the allowed subscription frequencies, use the
frequencies
attribute and populate it with an array of strings chosen from this list:hourly
daily
weekly
monthly
two-month
three-month
four-month
six-month
yearly
If you need to use a custom frequency that is not in the above list, crontab expressions are also accepted, as long as not more frequent than every hour (e.g. at minute 30 of every hour:
30 * * * *
is allowed, at every minute of the first day of the month: * * 1 * *
is not allowed )To set the subscription strategy for the associated market, use the
strategy
attribute. At the moment, two strategies are available:by_frequency
— as many order subscriptions as the different frequencies specified for the source order’s line items are generated, each with the related order subscription items (default strategy).by_line_items
— an order subscription is generated for any source order’s line item that has a frequency, each with the related order subscription item.
By default, the generated order subscriptions are automatically activated. Set the
auto_activate
attribute to false
if you want to override this behavior.If you set the
auto_cancel
attribute to true
(default is false
) the created order subscriptions will be automatically cancelled in case the source order is cancelled.Check the related ER diagram and explore the flowchart that illustrates how the subscription model resource relates to the other API entities.
Check the related guide to learn more about how to configure a subscription model and generate automatic subscriptions from a source order.
Last modified 6mo ago