What is a coupon?
Discount code that reduces the checkout total on hosted payment links. Coupons can be percent or fixed-amount, scoped to a single link or available to all links in the organization.How it works
- Codes are case-insensitive and validated server-side during checkout.
- Optional Max redemptions caps successful uses; each paid checkout increments the counter.
- Coupons can be paused (inactive) without deleting them; expired or over-limit codes are rejected.
- Fixed-amount coupons must be less than the order total; otherwise checkout returns an error.
Create a coupon
- Go to Payments → Coupons and click New Coupon.
- Fill Code, choose Percent or Fixed amount, and set Value.
- (Optional) Select a Payment Link to scope the code; leave blank for all links.
- (Optional) Set Max redemptions and/or Expires at.
- Keep Active on to enable immediately; save.
Redeeming at checkout
- Buyers enter the code in the coupon field on
/pay/{token}and click Apply. - The UI shows the discounted subtotal; errors show inline for invalid/expired codes, redemption limits, or discounts that exceed the total.
- Scoped coupons only work on their assigned link; org-wide coupons work everywhere.
Manage and iterate
- Edit scope, value, or limits as campaigns change; past redemptions stay recorded.
- Toggle Active to pause a campaign instead of deleting.
- Keep code naming consistent (e.g.,
SUMMER25) and avoid reusing codes across very different offers.