Cashback System
Reward customers with tiered cashback, scheduled promotions, category rates, and clear bonus spend rules.
PRO Cashback is a Pro feature.
Create a loyalty program that rewards customers with increasing cashback percentages as they order more. On Cashback Settings, the Earning and Redemption tabs control how bonuses are awarded and how they spend at checkout. The dashboard and the Mini App use the same rate resolver.
How it works
- You define cashback levels based on completed order count
- As customers complete more orders, they progress through levels
- Optional category rates and scheduled promotions can raise the rate (highest wins — never demotes a tier)
- Cashback is credited as store bonus balance
- At checkout, customers can apply bonuses within your Redemption rules
Configuration
Go to Cashback → Cashback Settings in the sidebar.
Enable cashback
Toggle Enable cashback to activate the system.
Earning tab — levels
Create tiers based on order count. Example:
| Level Name | Min. Orders | Max. Orders | Cashback |
|---|---|---|---|
| Bronze | 0 | 5 | 2% |
| Silver | 5 | 15 | 5% |
| Gold | 15 | — | 10% |
Click Add level to create new tiers. Leave Max. orders empty for no upper limit on the highest tier. Customers move up as their completed order count grows.
Category rates
Give a category its own rate. An order earns the best rate any item in it qualifies for, and a category never lowers what a customer's tier already earns. You need product categories first.
Scheduled promotions
Raise the rate over a date range (for example a holiday weekend or launch week). Dates are inclusive and interpreted in UTC.
- Add on top — added to whatever the customer already earns
- Replace — replaces the tier rate, unless the tier already pays more
- Optional Own cap for this promotion — without it, the store-wide cap still limits the boost
Status chips: Running now, Scheduled, Ended, Paused.
Preview
On Earning, use Preview to check what a customer would earn from completed orders, an order date, and an optional category. It uses the same resolver as the payout.
Cashback trigger
Choose when cashback is awarded:
Cashback is credited immediately when the order is created. Works with all order types including COD.
Cashback is credited when online payment succeeds (Stripe, Razorpay, Telegram Stars).
Cashback is credited when you manually move the order to a specific status (e.g., "Delivered"). Gives you the most control.
General settings
- Max cashback per order — cap the cashback amount per order (or leave unlimited)
- Description — explain cashback to your customers. Shown on their profile page.
Redemption tab — spending bonuses
On Redemption, configure how customers put earned bonuses toward a new order:
- Maximum share of an order payable with bonuses — applies to non-sale items only; sale items are always paid in full
- Bonuses and promo codes cannot be combined — when on, applying bonuses clears an entered promo code
These rules already ran at checkout; they now have a dedicated UI on Cashback Settings.
Customer experience
Customers see their current level, cashback percentage, and bonus balance on their profile page. At checkout, they can choose to apply accumulated bonuses toward their purchase within your redemption limits.