Promotions
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 thecart_itemsandcustom_itemsobjects.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.
note
Already existing promotions created before September 28, 2022 will not have created_by and updated_by attributes in their response body.
important
Line-item discounts are only supported by the line calculation method. For more information about this method, see the Calculation Method section.
The
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:item_fixed_discountfixed_discountx_for_yx_for_amountbundle_fixed_discountbundle_gift
The
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 withmax_applications_per_cart:1setting, the buyer can only use the free gift promotion once per cart. Ifmax_applications_per_cartis not set, the buyer can use the promotion multiple times. You can also setmax_applications_per_cartto zero to remove any usage limit.The
excludearray consists ofproductIDs orSKUs of products to be excluded from the cart-level promotions, such asfixed_discountandpercent_discount. However, the stores that use simple calculation method do not support excluding products from promotions.
The schema Object
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.
Promotion Codes
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.