The ClaimableManager component’s maxCouponsPerProfile property sets the maximum number of coupons a customer can use per order. The default is -1, which allows unlimited coupon uses.

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.