The ClaimableManager contains the maxCouponsPerProfile property, which identifies the maximum numbers of coupons that a customer can use per order. The default is -1, which allows unlimited coupon use.

As part of the coupon claiming process, the ClaimableManager.claimCoupon() method checks to see if the coupon claim limit has been reached, how many coupons are on the customer’s profile, and whether those coupons are valid for the current site. If the limit has not been reached, claiming proceeds as normal.

If the limit has been reached, two behaviors are available. The ClaimableManager.validMaxCouponLimitReachedActions property can be set to either of the following values:

It is up to your Web application to handle results from these behaviors.

The PricingTools class allows you to set the maximum coupons that can be used per order. The maxCouponsPerOrder property identifies the maximum numbers of coupons that can be used within an order on a site. The default value of -1 allows unlimited coupon use. By default, the maxCouponsPerOrder property is enabled, however, you can disable the property by setting the AllowMaxCouponsPerOrderLimit to false.

Once a customer has reached the coupon limit for the order, a message is presented that indicates the promotion name and the reason the coupon has been excluded.