Coupon System
Create discount coupons to offer promotions and drive sales.
Creating a Coupon
Go to eCommerce → Coupons → Add New.
Coupon Types
| Type | Description | Example |
|---|---|---|
| Percentage | Discount as a % of order total | 10% off |
| Fixed Amount | Fixed monetary discount | 5.00 off |
| Free Shipping | Waive shipping costs | Free delivery |
Coupon Settings
- Code — The coupon code customers enter (e.g.,
SUMMER2026) - Description — Internal description (not shown to customers)
- Discount Value — Percentage or fixed amount
- Minimum Order — Minimum cart total required
- Maximum Discount — Cap on the discount amount (for percentage coupons)
- Usage Limit — Total times the coupon can be used
- Per-Customer Limit — Times a single customer can use it
- Expiry Date — When the coupon expires
Restrictions
- Product restrictions — Apply only to specific products
- Category restrictions — Apply only to specific categories
- Exclude sale items — Don't apply to already-discounted products
Applying Coupons
Customers can apply coupons at the cart or checkout page by entering the coupon code in the designated field.
API Integration
Coupons are managed via the REST API:
| Endpoint | Method | Description |
|---|---|---|
/ec/v1/coupons/apply | POST | Apply coupon to cart |
/ec/v1/coupons/remove | POST | Remove coupon from cart |
/ec/v1/coupons/applied | GET | List applied coupons |