Discounts & couponsUpdated 2026-06-01
Create a coupon
Set the code, discount value, minimum purchase, usage limits, and validity.
The coupon form dialog lets you configure every aspect of a discount code.
Creating a coupon
- 1
Click Add coupon
The CouponFormDialog opens from the discounts toolbar. - 2
Set the code
Enter a unique code (e.g. SUMMER20). Codes must be unique per shop — duplicates return a 409 Conflict. - 3
Choose the discount type
Percentage (e.g. 20% off) or fixed amount (e.g. $10 off). - 4
Set a minimum purchase
Optionally require a minimum subtotal for the coupon to apply. - 5
Set usage limits & validity
Limit total redemptions, per-customer redemptions, and set start/end dates.
Coupon endpoints
GET
/coupon/statsDiscount dashboard summary metrics.
SessionGET
/coupon/listPaginated coupons. Filters: search, status.
SessionPOST
/coupon/createCreate a coupon (unique code per shop).
SessionPATCH
/coupon/update/:idUpdate a coupon.
SessionDELETE
/coupon/delete/:idDelete a coupon (disabled if already used).
SessionDeleting used coupons
A coupon that has already been redeemed cannot be deleted — only deactivated. This preserves order history integrity. Use the row actions menu to edit or delete.