Promotion Code
A promotion code is the code a customer types at checkout to redeem a discount. In Stripe, each promotion code points to a coupon.
Updated October 1, 2026
A promotion code is the code a customer enters at checkout to get a discount, such as LAUNCH20. In Stripe it is a promotion_code object that points to a coupon. The coupon defines the discount. The promotion code is the string customers share and type.
How promotion codes work
You create a promotion code on an existing coupon and give it a readable code. When a customer applies it, Stripe checks the code and adds the coupon's discount to their subscription or invoice.
- One coupon can back many codes.
PODCAST10andTWITTER10can share the same 10% off coupon, and you can count redemptions for each. - You can limit redemptions with
max_redemptions, anexpires_atdate, a first-time customer restriction, or a minimum order amount. - Codes are case-insensitive, so customers can type them in any case.
Why use them
You can publish a code without exposing coupon IDs or changing your prices. Per-code redemption counts show which channel brought each signup. If a code spreads too far, you can turn it off.
In ChargeBell
ChargeBell's checkout accepts promotion codes, so you can start a Pro subscription ($24/month) with a valid code applied. Stripe applies the discount as described above.