How it works
In Stripe there are two objects, and the difference trips people up.
- A coupon is the discount itself: a
percent_offor anamount_off(with a currency), plus a duration and optional limits such as a maximum number of redemptions and a last redeem date. It can apply to a whole order or only to specific products. - A promotion code is the customer-facing code, such as
LAUNCH20, that wraps around a coupon. Many promotion codes can reference one coupon. Promotion codes add the control layer: they can be limited to first-time customers, to a minimum spend, or to a single customer.
On Stripe Checkout, set allow_promotion_codes=true on the Checkout Session and the page shows a field where buyers enter a code. Payment Links offer the same option in their settings.
Example: the same license at 49
A license costs 49.00. All numbers are illustrative.
| Case | Calculation | Buyer pays |
|---|---|---|
| 20% off, quantity 1 | 49.00 x 0.80 | 39.20 |
| 10.00 off, quantity 1 | 49.00 - 10.00 | 39.00 |
| 20% off, quantity 3 | 3 x 49.00 = 147.00, minus 29.40 | 117.60 |
| 10.00 off, quantity 3 | 147.00 - 10.00 | 137.00 |
Stripe describes amount_off as the amount taken off the subtotal, so on the three-unit order the 10.00 comes off the 147.00 total once. Percent off scales with the order, a fixed amount does not. Pick the one that matches your intent: percent off for a general sale, amount off for a one-time goodwill gesture.
For subscriptions, duration matters more. A 20 percent coupon on a 9.00 monthly plan, with duration=repeating and duration_in_months=3, gives 7.20 for three invoices and 9.00 afterwards: 3 x 7.20 + 9 x 9.00 = 102.60 over the first year instead of 108.00. With the default duration of once, only the first invoice is discounted.
Coupon code versus a price change
A coupon leaves the list price untouched and records the discount on the order, which keeps reporting clean and lets you stop issuing it. A second, cheaper price is simpler to display, but you will carry it forever and every buyer can see it. For permanent groups such as students, a separate price can be right; see educational and volume discounts. For quantity pricing, see volume license.
How Clavem handles it
The discount happens entirely in Stripe. Clavem sees a paid checkout and issues the license the same way, whatever the amount was: a coupon changes what the buyer pays, not which key or device limit they receive. Quantity still counts, so three seats in one line item issue three keys, up to 100 per line item.
When a discount applies to a subscription, Stripe’s proration uses the discounted price (see proration). Clavem’s own annual billing, ten months for twelve, is a priced plan and not a coupon. Clavem has no coupon feature of its own. To bring a discounted purchase through Stripe Checkout, enable promotion codes there. Mapping and event details are in Connecting Stripe.
Questions
What is the difference between a coupon and a promotion code in Stripe?
A coupon defines the discount, such as 20 percent off. A promotion code is a customer-facing code that wraps around a coupon. Many promotion codes can point at one coupon, and only promotion codes can be restricted to first-time customers, a minimum spend or one customer.
Does a coupon apply to every renewal of a subscription?
Only if you set it that way. Stripe's coupon duration defaults to once, which discounts only the first invoice. Use repeating with a number of months, or forever, to discount more invoices.