Skip to content
Create account or Sign in
The Stripe Docs logo
/
Ask AI
Create accountSign in
Get started
Payments
Revenue
Platforms and marketplaces
Money management
Developer resources
APIs & SDKsHelp
Overview
Billing
OverviewAbout the Billing APIs
Subscriptions
    Overview
    How subscriptions work
    Get started
    Quickstart
    Plan an integration
    Build an integration
    Use cases
    About subscriptions
    Enable billing mode
    Configure subscription events
    Entitlements
    Subscription invoices
    Subscription schedules
    Recurring pricing models
    Set up subscriptions
    Configure collection methods
    Embed a pricing table
    Set billing cycles
    Manage subscriptions
    Migrate subscriptions to Stripe
    Set product or subscription quantities
    Mixed interval subscriptions
    Backdate subscriptions
    Set trial periods
    Handle subscriptions with deferred payment
    Apply coupons
    Modify subscriptions
      Change prices
      Cancel subscriptions
      Pause payment collection
      Manage prorations
      Manage pending updates
    Manage subscription payment methods
    Analytics
    Manage subscriptions on iOS
Invoicing
Usage-based billing
Quotes
Customer management
Billing with other products
Revenue recovery
Automations
Test your integration
Tax
Overview
Use Stripe tax
Manage compliance
Reporting
Overview
Select a report
Configure reports
Reports for multiple accounts
Reports API
Revenue recognition
Data
Overview
Query business data
Sigma
Data Pipeline
Import external data
United States
English (United States)
HomeRevenueSubscriptions

Modify subscriptions

Change existing subscriptions to cancel, pause, apply prorated charges and credits, and more.

You can change existing subscriptions without having to cancel and recreate them. Set up the customer portal to let your customers manage their own subscriptions and billing details through a Stripe-hosted page.

For changes that automatically create a new subscription invoice, use pending updates so that the updates are only applied if the new invoice is successfully paid.

Billing impacts

Not all subscription changes affect billing or generate prorations:

  • Billing-related updates create prorations and can generate invoices. These include changing prices, quantities, billing periods, or adding or removing subscription items.
  • Non-billing updates apply immediately without prorations. These include updating metadata, payment methods, tax settings, or applying discounts.

To see billing impacts before making changes, preview prorations.

Note

Configuration updates, like metadata and payment methods, don’t generate invoices with proration_behavior=always_invoice because they don’t change the amount owed for the current billing period. For a complete list, see What doesn’t trigger prorations.

Use cases

Change billing period

Adjust the billing date for subscriptions.

Change prices

Upgrade and downgrade subscriptions by changing the price.

Cancel active subscriptions

Manually cancel your customers’ subscriptions.

Pause payment collection

Temporarily stop collecting payments from your customers.

Apply discounts

Add discounts to subscriptions using coupons and promotion codes.

Use trial periods

Delay payments on active subscriptions using trial periods.

Set quantities

Subscribe a customer to multiple quantities of a product.

Collect taxes

Collect and report taxes with Stripe Billing and Stripe Tax.

Set payment methods

Specify which payment methods to allow for a subscription.

Manage prorations

Handle prorations for modified subscriptions.

Was this page helpful?
YesNo
  • Need help? Contact Support.
  • Check out our changelog.
  • Questions? Contact Sales.
  • LLM? Read llms.txt.
  • Powered by Markdoc