Coupons
Coupons are the workhorse promotion of any marketplace: a code customers apply at checkout for a benefit you define — a percentage or fixed discount, cashback, bonus reward points, free delivery, or free items. As the marketplace operator you decide where each coupon is visible, which orders it applies to, and you can read the cost and return of every offer in dedicated coupon reports.
Creating a coupon
Section titled “Creating a coupon”- Open Dashboard → Settings → Coupon and start a new coupon (the form lives at
/configuration/coupon/add/new). - Complete the Coupon Info section:
- Reference Name — internal only; your team sees it in the list, customers never do (e.g. “Grocery vertical launch 15%”).
- Coupon Code — what customers enter at checkout. Uppercase letters, numbers, and dashes (e.g.
FRESH-15). - Display Priority — ordering when multiple coupons are shown; lower numbers appear first.
- Visibility checkboxes — covered in Where customers see the coupon.
- For visible coupons, fill the Display Settings: customer-facing Display Title, Subtitle, Description, and an optional Coupon Banner Image (recommended 800x400px). Multi-language marketplaces can translate each text field.
- Configure the Coupon Logic — the benefit and the conditions (next sections).
- Save. The coupon joins the list and starts applying wherever its conditions are met.
Choosing the benefit
Section titled “Choosing the benefit”Under Coupon Logic, select a Benefit Type:
| Benefit Type | What the customer gets | Typical use |
|---|---|---|
| Discount | Money off the order total | Vertical launches, seasonal sales |
| Cashback | Credit to their wallet after the order | Driving the second order |
| Reward Points | Bonus reward points | Accelerating your loyalty program |
| Free Delivery | Delivery fee waived | Converting browsers in far zones |
| Free Items | Specific catalog items added at no charge | ”Free dessert over $40” bundles |
Monetary benefits can be calculated as a Percentage of the order or a Fixed Amount.
Conditions — scoping the offer
Section titled “Conditions — scoping the offer”The conditions builder stacks rules that all must pass before the coupon applies — a minimum order value, a specific business type, and similar constraints. On a multi-vertical marketplace this is how you keep a restaurant promotion from being redeemed on grocery orders: add a business type condition rather than relying on the code staying secret.
A coupon with no conditions applies to any order where the code is used, so review the rules before saving a generous offer.
Where customers see the coupon
Section titled “Where customers see the coupon”Two checkboxes in Coupon Info control exposure:
| Checkbox | Effect |
|---|---|
| Apply Coupon Section | Listed at checkout, where customers browse and apply available offers |
| General Coupon Section | Shown on the promotions page in your customer app |
Leave both unchecked to create a hidden coupon that only works when typed exactly — useful for partner merchants’ flyers, influencer codes, or support gestures, since redemptions then map cleanly to one channel.
Tracking redemptions
Section titled “Tracking redemptions”Coupon performance lives under Dashboard → Reports:
- Coupon transaction list (
/reports/coupon-reports/coupon-transaction-list) — each redemption with the customer, order, and benefit amount. - Coupon aggregate (
/reports/coupon-reports/coupon-transaction-aggregate) — per-coupon totals for side-by-side comparison.
Check the aggregate before renewing a campaign: a coupon that drives volume in a low-margin vertical can still be a net loss once the discount spend is totalled.
Example setups
Section titled “Example setups”Common marketplace patterns, built entirely from the options above:
| Goal | How to build it |
|---|---|
| Launch a new vertical | Discount, Percentage, business type condition scoping it to the new vertical, both visibility checkboxes ticked |
| Attribute an offline campaign | Hidden coupon (no visibility checkboxes), Fixed Amount — every redemption is provably from that channel |
| Convert customers in a far zone | Free Delivery with a minimum order condition |
| Raise basket size in groceries | Free Items with the minimum order condition set just above the vertical’s average basket |
| Feed the loyalty loop | Reward Points benefit — the promotion’s cost returns as future marketplace orders |
| Drive second orders from new customers | Cashback — value lands in the wallet and only pays off if the customer orders again |
Troubleshooting
Section titled “Troubleshooting”| Symptom | Try this |
|---|---|
| Customer reports the code “doesn’t work” | Check the conditions — usually a minimum order value not met, or a business type the coupon excludes |
| Coupon missing from checkout | Confirm Apply Coupon Section is checked; hidden coupons must be typed manually |
| Coupon listed in the wrong order | Adjust Display Priority — lower numbers are shown first |
| Percentage discount too generous on small baskets | Add a minimum order condition or switch to a Fixed Amount |
| Same offer needed for another vertical | Duplicate from the list, then change the code and the business type condition |
Related: Voucher campaigns · Marketing campaigns · Wallet · Reports