How redeem code settings work in SKU Management → Codes

You can configure redeem codes in Aghanim Dashboard → SKU Management → Codes. This is where you manage code behavior for your game hub, including discount logic and creator payout settings.

Where to configure codes

Open SKU Management → Codes in the dashboard for the environment you want to manage.

• Production: configure codes in your main game environment.
• Sandbox: codes should also work there, as long as the sandbox environment is configured correctly.

How discount-related settings work

Maximum discount to apply

This setting acts as an upper limit for the final discount applied to a purchase.

If a player buys an item that already has a store discount and then applies a code, the discounts can stack. Use Maximum discount to apply to cap the total discount so it does not exceed the value you specify.

If there is no store discount on the item, this setting does not independently change the discount for a single code.

If multiple discount codes are applied together, the effective upper cap is determined by the largest Maximum discount to apply value among the applied codes.

Stackable with discount codes

Enable Stackable with discount codes if you want a player to be able to apply multiple codes to a single purchase and have the discounts summed together.

This setting does not limit a player. It does the opposite: it allows multiple coupon discounts to be combined on the same checkout, so it should be used carefully to avoid abuse.

Does the discount affect the final item price?

Yes. For discount codes, the discount changes the amount the player pays for the item. It does not control an extra reward the player receives alongside the purchase.

For example, if a code is configured for a 50% discount, the player should pay 50% of the item price, unless there is also a store discount or another modifier affecting the final price.

If the item already has a store discount, that store discount is added on top of the code discount, subject to any configured maximum discount cap.

If you want to increase what the player receives rather than reduce the price, use a different code type such as bonus or free-item codes.

Can bonus and discount codes work together?

No. A checkout can apply either a bonus benefit or a discount benefit, but not both together.

The Stackable with discount codes toggle does not make bonus and discount benefits combine with each other. It only allows stacking within compatible benefit types.

If a player enters multiple codes with different benefit types on the same checkout, the system applies the code that was entered first.

Creator reward settings

The creator section is used to configure how a generated code is sent to a creator and what percentage reward that creator receives.

Yes — this percentage is set manually in the code configuration.

Where to add a creator

To add a new creator in the dashboard, go to Engagement → Creators.

Does a creator need approval before promo codes and referral links work?

Yes. After a creator is added, they receive an email with a link to a form where they provide their information and accept the applicable terms.

Once the creator accepts the terms, their status changes to Accepted. Promo codes and referral links start working after that status is reached.

How creator balances and payout data are updated

The creator balance is updated in real time.

Creators also receive a daily email with their daily statistics, cumulative statistics, and current balance.

How to verify whether a code was actually applied

If a purchase appears in the dashboard but the discount was not reflected on checkout, check the relevant webhook payloads such as item.add and order.paid.

If the payload for that order does not include the coupon or redeem code, that means the code was not actually applied at checkout for that purchase, even if you are investigating the order from the code side in the dashboard.

Why a bonus code can fail with a quantity-related error

If you see an error like This coupon can only be used for items purchasable in quantities greater than one, the problem is not necessarily related to whether a creator is attached to the code.

A common cause is that the code is configured as a percentage bonus code. This type of code adds extra quantity of the purchased item rather than lowering the price.

If the target item is passed as a non-stackable item with quantity = 1, there is no additional quantity for the bonus logic to apply to, so the system rejects the code.

To use that type of bonus code successfully, either:

• pass the item as stackable with quantity > 1 when creating the order, or
• test the code on a stackable item configured in the dashboard where quantity can be greater than one.

If your goal is to reduce the purchase price rather than grant extra quantity, use a discount code instead of a bonus code.