Admin guide
Coupons
Percentage, fixed, and free-shipping codes with constraints.
Create discount codes at /admin/coupons.
Types
- Percentage — N% off the subtotal.
- Fixed amount — €X off the subtotal.
- Free shipping — zeroes the shipping line.
Constraints
- Minimum subtotal — e.g. "€50 to qualify".
- Usage cap — total number of redemptions, across all customers.
- Expiry — the moment after which the code stops working.
- Active toggle — pause without deleting.
Stripe mirroring
When you create a coupon, NShop mirrors it as a Stripe Coupon so it appears with its proper name and discount on the Stripe Checkout page itself, not just on your own summary.
Code uniqueness
Codes are namespaced per tenant — two stores can both have SUMMER10
without conflict. (The document ID is {tenantId}_{code} under the
hood.)
Customer-facing validation
Shoppers can paste a code in the cart and immediately see the discount preview. The validation endpoint runs the same server-side checks as checkout, so what they see is what they'll pay.