Promotion rules

The promotion rule object and the allowed CRUD operations on the related resource endpoint

Commerce Layer provides a promotional engine built on top of two main resources: promotions and promotion rules.

At the moment the following promotion rules are available (more to come):

The number of promotions associated with a coupon code promotion rule is unlimited. The number of promotions associated with any other promotion is subject to limitations: by default, only a maximum of 10 active promotions per organization is allowed, regardless of their type (this limit may vary depending on your plan). Please note that you can create and enable as many promotions as you want but, if more than 10 promotions are active at the same time, only the 10 that have higher priority will be applied.

If one or more promotion rules are defined, the promotion is triggered only when it matches all of them. Otherwise, if no promotion rule is associated with an active promotion, the related discount is applied to:

  • All the orders, if the promotion is not restricted to a specific currency or market (only possible for buy X pay Y, free gift, free shipping, of percentage discount promotion types).

  • All the orders in the specified currency, if a currency code is specified but the promotion is not restricted to a specific market.

  • All the orders of the market in scope, if the promotion is attached to a market.

This is an immutable API, meaning that create, update, and delete operations are not allowed on this endpoint. You can only fetch a list of promotion rules or a specific single one.

Last updated