
Overview
The coupon system lets you create promotional discount codes that work across both your shop and restaurant checkout flows.
Creating a Coupon
Navigate to Coupons > Create Coupon in the sidebar.
Discount Types
| Type |
Description |
Example |
| Percentage |
Percentage off the subtotal |
10% off |
| Fixed Amount |
Fixed SAR amount off |
15 SAR off |
| Free Shipping |
Waives shipping fees (Shop only) |
Free delivery |
Conditions
- Minimum order amount — Coupon only valid for orders above this amount
- Maximum discount amount — Cap on percentage discounts (e.g., 20% off but max 50 SAR)
- Total usage limit — How many times the coupon can be used in total
- Per customer limit — How many times each customer can use the coupon
Scheduling
- Start date — When the coupon becomes active
- End date — When the coupon expires
- Active toggle — Immediately enable or disable
How Customers Use Coupons
At checkout (both shop and restaurant), customers enter the coupon code in the "Coupon code" field and click "Apply". The discount is calculated and displayed in real-time in the order summary.
Safeguards
- Discount can never exceed the order subtotal (no negative totals)
- Only one coupon per order
- Usage count is incremented atomically with database locking to prevent race conditions
- Coupon usage is revoked if an order is cancelled