You are here:
Redemption Limits for Multiple Coupons in the Same B2C Commerce Order
Shoppers can apply multiple coupon codes in one B2C Commerce order.
For example, a site enables teachers to order books for multiple students. Each student can select one or more books, and then use a coupon for a FREE BOOK. The coupon codes in this promotion belong to the same coupon, and the coupon is sent to the students via a flyer or email. The teacher enters the book orders and the coupon codes into the site for the students. Each student that presents the coupon gets a book at no cost.
When a shopper adds multiple coupons to a cart, each code is associated with a coupon line item.
Configure redemption limits per order on the General tab of a coupon's configuration.
Coupon validation depends on the redemption limit configuration.
- Redemption per Coupon Code—the limits are validated in the same way as other promotions. If a coupon code is redeemed up to its limit, it can’t be added to the cart.
- Redemption per Customer—validation depends on past orders and coupon codes currently in the cart. For example, you configure a coupon for use three times per shopper. The customer uses it in a previous order but there are two coupon codes in the cart. A customer can’t add another code for the same coupon to the cart.
- Redemption per Time Period—validation depends on past orders and coupon codes currently in the cart. For example, a coupon can only be used three times in a week, and the customer has used it one time in an order they placed six days ago. There are still two coupon codes in the basket, but the customer can’t add another code for the same coupon to the basket.
If a promotion applied to a basket is qualified by multiple coupon codes, the promotion can apply more often.
- If the promotion type doesn't support multiple coupon code applications, then the behavior doesn't change.
- If the promotion type supports multiple applications, but the promotion is configured with the max applications field blank, there’s no limit.
- If the promotion type supports multiple applications, and the max applications setting is set to a finite number, then the promotion applies up to the max applications per coupon code. In other words, the effective maximum application is equal to the maximum applications allowed times the number of coupon codes.
This coupon setting merely extends the potential number of times a promotion can be applied. Otherwise, the standard B2C Commerce behavior applies. For promotions with purchase conditions, it isn't necessary to satisfy the purchase conditions multiple times. Products aren't discounted multiple times, and exclusivity rules remain the same.
The exception is product promotions of type With Amount of Qualifying Products and Without Qualifying Products. These two promotions grant a Choice of Bonus Product discount. This promotion type shows a maximum applications field, though it isn't used. For example, a customer has $150 worth of qualifying product in the basket. If there’s a promotion to buy $75 worth of qualifying products and get a bonus product promotion, this coupon doesn't result in two bonus products granted. This promotion grants a bonus-product for each distinct coupon code in the basket. The amount of money isn't the triggering factor.
Implement this feature using B2C Commerce APIs.

