Using multiple coupons on one order and understanding coupon types

One order can have multiple coupons applied. This is why the coupons field is returned as a list in both Get Order responses and order-related webhooks.

How to allow multiple coupons on one order

Multiple coupons are only accepted when the coupon combination is configured to be stackable.

1. In the Dashboard, open each coupon you want to combine.
2. Go to Coupon Base Settings.
3. Enable Stackable with bonus coupons and/or Stackable with discount coupons depending on the combination you want to allow.
4. Optionally set a limit percentage to cap the combined total benefit.

Important: both coupons must opt in to stacking. If the combination is not allowed, applying the second coupon at checkout returns 409 and the error is shown inline to the player.

How players apply multiple coupons

At checkout, players add coupon codes one at a time using the Add promotion code input. There is no batch endpoint for submitting multiple coupon codes at once.

Coupon types

• bonus — Adds extra quantity to stackable items in the order, using bonus_percent or bonus_fixed. It does not change the order price; it changes what the player receives. Requires at least one item with is_stackable = true.
• discount — Applies a percentage discount to the order subtotal using discount_percent.
• discount_fixed — Applies a fixed USD discount amount from a balance pool stored on the coupon itself. It behaves like a gift card, and repeated redemptions reduce the remaining balance. It is not combinable with regular discount coupons.
• discount_reward_point — Uses the same mechanics as discount_fixed, but the discount is funded by the player’s reward points instead of a coupon-level balance.
• free_item — Grants a specific item for free. This is a hub coupon that is redeemed through the hub rather than applied during checkout.
• vc — Grants a specified quantity of virtual currency. This is also a hub coupon and follows the same delivery model as free_item.
• non_benefit — Provides no monetary discount and no extra quantity. It is used for attribution and tracking, such as creator, affiliate, or campaign tagging, and can be used for revenue-share reporting without changing the order price.

Webhook and API behavior

In webhook payloads and order responses, coupons is a list because more than one coupon can be redeemed against a single order when stacking is allowed.