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

On this page