How to offer an annual discount in Stripe
The cleanest way to offer an annual discount in Stripe is to give the product a second Price with a yearly interval, set below twelve times the monthly price. A coupon can do the same job, but it is built for discounts that start and end, not for a permanent plan. This guide shows the setup, a worked example, and what happens when a monthly customer switches.
Everything about Stripe's behavior below comes from its documentation, read on 12 November 2026.
Yearly price or coupon?
Stripe gives you two mechanisms, and they answer different questions. A Price says how much and how often you charge. A coupon takes money off a charge for a set period. Stripe's coupon docs say a coupon's duration is once by default, which covers only the first invoice. You can also set repeating with a number of months, or forever.
That default is the trap. If you create a "20% off" coupon and attach it to a yearly subscription with once, the customer gets the discount on the first invoice and pays full price at renewal. A yearly Price avoids the question because the discount is part of the price.
Use a yearly Price when the discount is a standing feature of your pricing page. Use a coupon when you want a launch offer, a partner deal, or a win-back that ends. The post on Stripe coupons versus promotion codes covers the second case in more detail.
A worked example
Say your plan costs $20 a month. Twelve months at that rate is $240. If you price the yearly option at $200, a customer pays for ten months and gets twelve. The saving is $40, or about 17%. Those numbers are an example, so pick your own from your churn and cash needs. How to price a SaaS product at the early stage explains how to choose the monthly figure first.
Two things are worth deciding before you set the yearly number. First, whether you want to describe the offer as months free or as a percentage, since buyers compare either. Second, whether the yearly customer gets anything extra. A discount alone is a cash trade: you collect twelve months today and accept less per month.
Set it up in the Dashboard
- Open the product you already sell monthly.
- Add another Price on the same product.
- Choose recurring, and set the billing period to yearly.
- Enter the yearly amount, for example $200.
- Copy the new Price ID.
Stripe's recurring pricing models page lists flat rate, per-seat, tiered, and usage-based models, and each can take a yearly Price. Put both Prices on your pricing page and pass the matching Price ID when you create the Checkout Session. If you use a no-code pricing table, add both intervals to it.
Applying a coupon on top
You may still want a coupon for a campaign. In a Checkout Session you pass the coupon ID in the discounts parameter, and the docs show this for subscription mode. Stripe also lets you attach up to 20 discounts to a subscription, and the order matters when you mix a percentage with a fixed amount. For example, 20% off then $5 off gives a different total from $5 off then 20% off.
If the offer should be redeemable by code, wrap the coupon in a promotion code. Stripe's docs list the controls: restrict it to first-time customers, set a minimum order value, set an expiry date, and cap the number of redemptions. A coupon's max_redemptions counts every application, whether it came from a code or from your own backend.
What happens when a monthly customer switches
Existing customers will ask to move to the yearly plan. Stripe's change-price guide says that if the two Prices have different billing periods, the new price bills at the new interval starting on the day of the change. Switching from monthly to yearly moves the billing date to the date of the switch.
Some practical consequences follow from that page:
- Stripe tries to collect payment immediately when the billing cycle anchor resets. If payment fails, the change still goes through and the subscription becomes
past_due. - When you update the subscription, pass the existing subscription item ID. Without it, Stripe adds the new Price next to the old one and the customer is charged for both.
- Updating the price resets the quantity to 1. Include the current quantity if it is higher.
- Proration can apply to the remaining days. You can preview it before the customer confirms, or disable it.
If you prefer to make the switch at the end of the current period, the same page points to subscription schedules.
Who should pick which approach
- Choose a separate yearly Price if the annual plan is permanent and you want renewals to stay discounted without extra setup.
- Choose a coupon with
repeatingduration if the discount should last a fixed number of months, such as a first-year offer. - Choose a promotion code on top if you want to hand the offer to a specific audience, such as newsletter readers.
If you list your product's offers on other channels, Dealpuffin lets founders who bill through Stripe, Paddle or Polar publish coupons from their provider, so the Stripe objects you create here can be reused.
Frequently asked questions
Should the annual discount be a coupon or a separate price?
A separate yearly Price is simpler for a permanent plan, because the renewal amount stays the same. Coupons suit discounts with an end date.
How long does a Stripe coupon last?
By default a coupon applies once, which is the first invoice only. You can set a repeating duration in months or make it last forever.
What happens if a monthly subscriber switches to yearly?
The new Price bills at the yearly interval starting on the day of the change, so the billing date moves to the switch date. Stripe attempts payment immediately and may prorate the remaining days.
Can I stack a promotion code on a yearly plan?
Yes. Stripe supports up to 20 discounts on a subscription, though you cannot pass a coupon and a promotion code created from that same coupon together.