Skip to content
  • Billing
  • Manage plans

Plan upgrade and downgrade policies

If you offer different levels of paid plans, then you will need to facilitate plan upgrades or downgrades. Before you make plan changes, make sure you have set the policies.

Set billing policies for cancellation and plan changes

Link to this section

You can also set policies to control what happens when a customer cancels or changes their plan. The policies are for deciding if you charge or forgive unpaid usage of metered features, and if you refund or retain unused, paid subscription days.

By default, unpaid usage is forgiven and you don’t refund or credit for unused subscription days.

  1. Go to Settings > Environment > Billing to set these policy defaults.
  2. In the Policies section, choose the settings. Billing policies settings
  3. Select Save.

Immediate and scheduled cancellations

Link to this section

These policies apply when a subscription is cancelled immediately.

If the plan’s Cancellation takes effect setting (or the timing you choose in admin or the API) is the end of a billing period:

  • The customer keeps access until that date.
  • Stripe always issues the final period invoice at the effective date. The invoice-now policy does not apply to a scheduled cancel.
  • Unpaid usage up to that date can still be charged, depending on your usage policy.
  • On a single-interval plan, access through that date usually aligns with what the customer already paid for in advance. Your environment policy for refunding unused subscription days applies on immediate cancellation; it does not trigger a separate refund when someone schedules a cancel.
  • On mixed-interval plans (for example monthly plus annual), cancelling at the earliest period end can end access before a longer-interval charge would naturally renew. Proration may apply when that charge is cut short. Any refund or credit for unused prepaid time follows your unused-day policy and appears on Stripe’s final invoice at the effective date - not as an instant refund at schedule time.
  • One-time purchases on the agreement stay available until it ends, unless they expire sooner under Expires with the billing cycle.

See Cancel a subscription.