With promotions, you can provide different types of discounts to all your customers or specific customers. A promotion can be set to apply automatically or by entering a code. Automatic promotions are applied when the selected items meet the promotions criteria. Promotions with codes are applied when customers enter the promotion code to get to discount. Elastic Path Commerce Cloud offers the following types of promotions:
fixed_discount: Adds a fixed amount discount to a cart.
percent_discount: Adds a percentage discount to a cart based on the value of the
x_for_y: Provides an option to sell more than one item of the same product for a specific price. For example, 2 for 1 or 3 for 2 promotions. If a cart contains more items that are eligible for 2 for 1 promotion, the promotion amount is multiplied by the number of eligible collection.
x_for_amount: Provides an option to sell a specific number of items of the same product for a fixed amount. For example, buy two items for $10 or four items for $20.
bundle_fixed_discount: Provides a fixed price for a selection of products when you buy the selected products together. For example, buy products x, y, and z for $15 or buy two x and three y or z for $25.
item_fixed_discount: Reduces the product price for multiple items by a fixed amount, such as $5.00 off.
item_percent_discount: Reduces the product price for multiple items by a percentage, such as 10% off.
bundle_gift: Offers a free item when a specific product or a group of products are purchased.
To learn how promotions work with bundles, see Understanding How Promotions work with Bundles.
Already existing promotions created before September 28, 2022 will not have
updated_by attributes in their response body.
Line-item discounts are only supported by the line calculation method. For more information about this method, see the Calculation Method section.
max_discount_valuesetting specifies the maximum possible discount for the cart. To avoid the conflict with the promotions and the promotion to work, we recommend not to use this setting for the following promotions:
max_applications_per_cartsetting, which specifies the maximum number of applications of a promotion per cart, is applicable to line-item promotions only. For example, in a store that offers buy SKU1 get a free gift promotion with
max_applications_per_cart:1setting, the buyer can only use the free gift promotion once per cart. If
max_applications_per_cartis not set, the buyer can use the promotion multiple times. You can also set
max_applications_per_cartto zero to remove any usage limit.
excludearray consists of
SKUs of products to be excluded from the cart-level promotions, such as
percent_discount. However, the stores that use simple calculation method do not support excluding products from promotions.
Promotions are defined by schemas that are used internally to verify promotions and calculate discounts. For each promotion, you must define schema when you create the promotion.
You can apply promotions automatically to all customer carts, or you can create promotion codes that customers must enter to receive the discount. For more information, see the Creating Promotion Codes section.