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
frequenciesattribute and populate it with an array of strings chosen from this list:
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
strategyattribute. 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
falseif you want to override this behavior.
If you set the
false) the created order subscriptions will be automatically cancelled in case the source order is cancelled.