Store
Coupons
Create discount codes for your city's store, with use limits, dates, a minimum purchase and discounts on chosen categories or products only.
Create discount codes for your city's store, with use limits, dates, a minimum purchase and discounts on chosen categories or products only.
Coupons are discount codes players type when they buy. They work well for launches, city events, streamer partnerships and welcome deals for first-time buyers. Each coupon can apply to the whole store or only to some categories or products, and can have a use limit, a start date and an end date. This page is for whoever runs the store’s catalogue and promotions.
| Action | Level |
|---|---|
| Coupons and sales with coupons | View |
| Create, edit and turn off coupons | Configure |
Members with only View see the list and the numbers, but not the buttons to create, edit, enable, disable or delete. See Team and permissions.
In the sidebar, open Store → Coupons and click New coupon. If the store has no coupons yet, click Create coupon or pick a template under Start from a template.
Under Code, type the code (e.g. WELCOME10) or click Generate for a random code.
Under Discount type, pick Percentage or Fixed amount and fill in Discount percentage or Discount amount.
Under Applies to, pick Whole store, Categories or Products. For categories or products, select the ones that get the discount.
Under Conditions and limits, turn on what you need: Minimum purchase, Use limit, Per player and First purchase only. Under Expiration, turn on Schedule start and End date if the coupon has dates.
Check the Summary and click Create coupon. The coupon works right away (or from the start date, if you scheduled one).
When the store has no coupons yet, the page offers three templates. They only fill in the form; you can change everything before saving.
| Template | Suggested code | What it fills in |
|---|---|---|
| Welcome | WELCOME10 | 10%, once per player, First purchase only, no end date |
| Launch | LAUNCH20 | 20%, once per player, Use limit of 100, ends in 7 days |
| Partnership | PARTNER15 | 15%, once per player, no end date |
| Field | What it does | Default |
|---|---|---|
| Code | What the player types. 3 to 24 characters: letters, numbers, - and _. Not case-sensitive; spaces become - and accents are dropped. Can’t repeat another coupon in the store. | Empty |
| Generate | Creates a random 6-character code with no look-alike characters (0/O, 1/I/L). | — |
| Discount type | Percentage (1% to 100%) or Fixed amount (in reais, up to R$ 50.000,00). | Percentage |
| Applies to | Whole store, Categories or Products. For categories or products, pick at least 1 and at most 50. | Whole store |
| Minimum purchase | The cart has to reach this amount for the coupon to work. On a fixed-amount coupon, the minimum can’t be lower than the discount. | Off: works on any amount |
| Use limit | Total uses for everyone. When it reaches the number, the coupon is Used up. 1 to 1,000,000. | Off: unlimited |
| Per player | How many times each player can use it. 1 to 1,000. | Off: each player uses it as often as they like |
| First purchase only | Only works for players who’ve never had a paid order in the store. | Off |
| Schedule start | The coupon only works from the Start date and time. | Off: works as soon as it’s saved |
| End date | The coupon stops working by itself at the End date and time. Shortcuts: Tomorrow, 7 days, 15 days, 30 days. The end must be after the start. | Off: works until you disable it |
| Internal note | Text only the team sees (e.g. “partnership with streamer X”). Up to 120 characters. Also searchable. | Empty |
A store can have up to 300 coupons. To create more, delete old ones.
The status is worked out live, in this order:
| Status | When it shows |
|---|---|
| Disabled | You disabled the coupon. It stops working, but its history stays. |
| Scheduled | The start date hasn’t come yet. |
| Expired | The end date has passed. |
| Used up | The coupon reached its Use limit. |
| Active | It works right now. |
In the list, the filter has All, Active, Scheduled, Ended (expired and used up) and Disabled. Search looks at the code and the note.
Each row shows Coupon, Discount, Uses, Expiration and Status, plus where it applies (e.g. Whole store, 3 categories) and its conditions (e.g. first purchase, 1 per player). Click the code to copy it. In the row’s actions menu:
| Action | What it does |
|---|---|
| Copy code | Copies the code so you can share it. |
| Edit | Opens the coupon to change any field. |
| Duplicate | Opens a new coupon with the same rules, with no code and no dates. |
| Enable / Disable | Turns the coupon on or pauses it without losing its history. |
| Delete | Deletes the coupon. The code stops working right away and this can’t be undone. |
On the store website: at checkout, the player types the code in the Coupon or creator code field and clicks Apply. The summary shows a Coupon [code] line with the discount. To remove it, they click Remove coupon [code]. On the website, a coupon and a creator code can be used together.
On Discord: if the store sells on Discord, the cart has a Coupon button with the same rules as the website. Under Store → Sales channels, the Coupons option turns that button on or off, and Coupon and code together sets whether the coupon and the creator code add up (off, using one removes the other). See Sales channels.
Discounts apply in this order: first offers (bundles and quantity), then the coupon, then the creator code. Wallet credit is used last, on what’s left.
| Situation | Message |
|---|---|
| Not started yet | Coupon [code] isn’t active yet. |
| Past its date | Coupon [code] has expired. |
| Hit its limit | Coupon [code] has run out. |
| Disabled | Coupon [code] isn’t active. |
| Already bought before | Coupon [code] is only for your first purchase at the store. |
| Used the maximum | You’ve already used coupon [code] as many times as allowed. |
| Code doesn’t exist | We couldn’t find that code. Check that you typed it right. |
If the cart doesn’t reach the Minimum purchase yet, the coupon stays saved and starts working once the cart reaches the amount.
A use only counts when the payment is approved. While an order waits for payment, it already holds a spot in the Use limit and Per player: if the limit is reached counting those orders, the player sees “This coupon’s limit has been reached, including orders awaiting payment.”
At the top of the page:
| Card | What it shows |
|---|---|
| Sold with coupons · 7 days | Sales with a coupon over the last 7 days, compared with the previous 7 days, with Discount given, Orders with a coupon and Return (sales per R$ 1 of discount). |
| Uses · 7 days | Uses per day over the week. |
| Active now | How many coupons work now, out of how many in total, and how many end within 7 days. |
Each row in the list also shows how much discount the coupon gave, across how many orders, and how much it sold.
The player typed it in lower case. Does it work?
Yes. Codes aren’t case-sensitive: welcome10 and WELCOME10 are the same coupon.
Can I discount only the VIPs? Yes. Under Applies to, pick Categories and select the VIP category, or pick Products and select each VIP.
I changed the coupon. Are past buyers affected? No. The change applies to the next purchases. Orders already placed keep the discount they had.
What’s the difference between a coupon and a creator code? A coupon is a store discount. A creator code belongs to the affiliate program: it gives the buyer a discount and counts the sale for the creator. See Affiliates.