Promo codes and discounts
A promo code is a code that a player enters during checkout (or wallet top-up) to receive a discount, a free product, or bonus funds.
Promo code types (6 kinds)
| Type | What it gives | Example |
|---|---|---|
| discount_percent | Percentage discount | WELCOME → −10% on everything |
| discount_fixed | Fixed-amount discount | SAVE100 → −100 ₽ |
| free_product | Free product | GIFT → AK-47 for free |
| balance_topup | Bonus added to balance | BONUS500 → +500 ₽ to balance |
| free_shipping | Free shipping | (not applicable — digital products) |
| composite | Combination | Discount + bonus |
Promo code parameters
| Parameter | Description |
|---|---|
| code | The code itself (e.g. WELCOME2024) |
| type | Promo code type |
| value | Value (percentage, amount, or product ID) |
| maxUses | How many times it can be used (null = unlimited) |
| usedCount | How many times it has been used (counter) |
| minCartMinor | Minimum cart amount (null = no limit) |
| startsAt | Start date (null = immediate) |
| expiresAt | Expiry date (null = no expiry) |
| isActive | On/off |
How to create a promo code
- Admin panel → your store → Promo → "Create promo code"
- Fill in the parameters
- Save
- The promo code is immediately active (if
isActive: true)
How a player applies a promo code
- During wallet top-up or purchase — a promo code input field is shown
- The player enters the code → the system checks:
- The code exists
- It is active (
isActive: true) - It has not expired (
expiresAt) - The usage limit has not been reached (
maxUses) - Cart ≥
minCartMinor
- If everything is valid — the discount / bonus is applied
Creator codes (referral program)
A creator code is a promo code linked to a content creator (streamer, blogger). The store owner receives a percentage of purchases made with this code.
Status: 🚧 in development (Phase 4)
Planned mechanics:
- The streamer receives a unique code (e.g.
STREAMER123) - A player enters the code → the streamer earns a % of the purchase
- Revenue share is configured by the store owner
- CreatorAttribution is recorded on the order
Next steps
- Top-up bonuses — bonuses on wallet top-up