Flex promotions

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

Flex promotions enable you to cover the most comprehensive range of use cases you may need in your promotion strategy.

Order rules

Flex promotions leverage our Rules Engine integration with Commerce Layer Core API and, when triggered, are responsible for adding a discount to the orders involved based on the conditions and actions provided in the associated rules.

How-to

Please refer to the Rules Engine documentation to learn more about how to set up promotional rules, define conditions and actions, browse the most common use cases, and more.

Flex promotions, together with the Rules Engine integration, are still in beta and available only to our enterprise customers. If you're one of them and want to test and leverage its functionalities reach out to us and request to be part of the beta program.

For performance reasons, rules, rule_outcomes, and resource_payload objects are returned when retrieving a single flex promotion only.

Application scope

Except for the case where you need them to be associated with a coupon, when using flex promotions you're not required to define any promotion rules, set a currency code, or associate a specific market. Just use the rules JSON object to define how and when the flex promotion should be applied.

Discount calculation and distribution

The total discount due to flex promotions is calculated and distributed on the matching line items, based on the conditions and actions provided in the associated rules.