Price frequency tiers

The price frequency tier object and the allowed CRUD operations on the related resource endpoint

Price frequency tiers let you segment the pricing of your products by defining different prices for specific intervals based on frequency (usually leveraged to offer subscription-based discounts). The price of the associated SKU will be set by the tier the frequency specified for the related order's line item purchased falls within. The available frequencies are the same as for subscriptions (string label or crontab expression). As a custom frequency an integer (number of days) is also accepted.

For each tier the main attributes you need to specify are:

  • up_to — the tier's upper limit (in terms of the line item frequency — expressed in days or using one of the allowed frequency labels).

  • price_amount_cents — the unit price to be used for the related SKU if the frequency of the associated line item is lower than (or equal to) the up_to limit.

If the up_to attribute is null the related tier will be considered a beyond tier, meaning that the specified unit price will be used if the frequency of the line items associated with the SKU's is greater than the maximum tier's upper limit. If no beyond tier is set the standard SKU's price amount_cents will be used as the beyond price.

Just like price volume tiers price frequency tiers can be imported together with the related prices.

Last updated