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_items
andcustom_items
objects.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.
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_value
setting 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_discount
fixed_discount
x_for_y
x_for_amount
bundle_fixed_discount
bundle_gift
The
max_applications_per_cart
setting, 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:1
setting, the buyer can only use the free gift promotion once per cart. Ifmax_applications_per_cart
is not set, the buyer can use the promotion multiple times. You can also setmax_applications_per_cart
to zero to remove any usage limit.The
exclude
array consists ofproductID
s orSKU
s of products to be excluded from the cart-level promotions, such asfixed_discount
andpercent_discount
. However, the stores that use simple calculation method do not support excluding products from promotions.
schema
Object
The 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.