Subscriptions

Learn how to use the subscription resource with Stripe Billing.

Subscriptions are a core resource in Stripe. They represent what your customer is paying for and how much and how often you’re charging them for the product. You build and manage subscriptions by using other core Stripe resources, like Customers, Products, Prices, and Invoices, and PaymentIntents.

You can create and update subscriptions from the Dashboard or the API. Use the API if you have a large number of subscriptions to manage, or if you want to manage them programmatically.

You can subscribe customers:

Manually through the Dashboard
With Payment Links
Programmatically through the API
Through your website by embedding pricing tables and linking to a Checkout session

Manage how you notify customers about different subscription events in the subscriptions email settings page of the Dashboard.

Create a subscription

To create a subscription:

In the Stripe Dashboard, go to the subscriptions page.
Click +Create subscription.
Find or add a customer.
Enter the pricing and product information, which allows you to add multiple products, a coupon, or trial to the subscription.

Advanced options

Edit a subscription

To edit a subscription:

Go to the subscriptions page.
Find the subscription you want to modify, click the overflow menu (
), then click Update subscription. You can also click the
next to the subscription name. From this menu, you can also:
- Cancel the subscription. In the modal that opens, select the date to cancel the subscription—immediately, at the end of the current period, or on a custom date. You can also select the option to refund the last payment for this subscription and create a credit note for your records.
- Pause payment collection. In the modal that opens, select the duration of the pause—indefinite or ending on a custom date—and how invoices should behave during the pause.
- Share an update payment details link. In the modal that opens, you can share a link with the customer to update their payment details. For more information, see Share an update payment details link.
Make your changes to the subscription.
Click Update subscription.

Delete a subscription

You can’t delete a subscription. But you can cancel it or pause payment collection. See editing a subscription for those details.