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. 1

    Click Add coupon

    The CouponFormDialog opens from the discounts toolbar.
  2. 2

    Set the code

    Enter a unique code (e.g. SUMMER20). Codes must be unique per shop — duplicates return a 409 Conflict.
  3. 3

    Choose the discount type

    Percentage (e.g. 20% off) or fixed amount (e.g. $10 off).
  4. 4

    Set a minimum purchase

    Optionally require a minimum subtotal for the coupon to apply.
  5. 5

    Set usage limits & validity

    Limit total redemptions, per-customer redemptions, and set start/end dates.
Coupon endpoints
GET/coupon/stats
Discount dashboard summary metrics.
Session
GET/coupon/list
Paginated coupons. Filters: search, status.
Session
POST/coupon/create
Create a coupon (unique code per shop).
Session
PATCH/coupon/update/:id
Update a coupon.
Session
DELETE/coupon/delete/:id
Delete a coupon (disabled if already used).
Session

Deleting 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.