Designing an integration

You need to understand the available subscription models to help you make later choices, such as which pricing model and payment form to use. First, consider your business model:

• If you want customers to pay, then provision access to your service, click the pay up front tab below to learn more.
• If you want to collect payment details, then offer customers a free trial period before billing them, click the free trial tab below to learn more.
• If you want to provide users access to your service without asking them for any payment information (a freemium model), click the freemium tab below to learn more.

Pay up front

Free trial

Freemium

Pay-up-front model

In the pay-up-front model, you collect payment details and charge customers before provisioning access to your service. After the initial charge, you continue to charge customers the same fixed price for the same service at regular intervals. In this model, you use the Dashboard or Subscriptions API manage customer subscriptions. If you want to allow customers to modify their subscriptions directly, you need to integrate the customer portal.

For example, a photo hosting company that offers basic and premium service levels and charges customers on a monthly basis might have this setup:

• One product for the basic option
• One product for the premium option
• One price for the basic option (15 USD per month)
• One price for the premium option (25 USD per month)

A typical flow for this model would look like the following:

1. The customer chooses their plan (basic or premium).
2. You collect payment information.
3. You provision access to your service. You know when to do this by monitoring webhook events.
4. You continue to provision access for customers throughout the lifecycle of the subscription. Check regularly to make sure you’re not providing access if a customer’s payment has failed.

See the integration guide to learn how to build an integration with a low-code approach that uses a pre-built and hosted page from Stripe Checkout or a custom version with Stripe Elements.

If you need to meter usage, see metered billing. You need to do this when you create a price.

If you don’t want to write a lot of code, use Checkout, Stripe’s pre-built, hosted payment page. See the subscriptions with Checkout integration guide to get started.

If you want a more customised payment form that you can embed into your existing website, use Elements, a set of pre-built UI elements that’s part of Stripe.js.

Embed a pricing table on your website to show customers pricing information for subscriptions. When customers choose a subscription option, they’re taken directly to checkout. Configure, customise, and update directly in the Dashboard without writing any code.

If you’re collecting payment information with Checkout, you can use the customer portal to allow customers to directly update their subscription details, such as payment method and frequency. See the integration guide for detailed instructions on setting this up. (Before integrating, you should also be aware of the limitations of the portal.)

If you’re integrating with Elements, you can add a form on the front end to collect details about the plan they want to change (such as the price ID and their customer information) and send that to an endpoint on the back end. For more details and sample code, see the section about letting customers change their plans in the Elements quickstart.

If you’re providing the same good every month and don’t expect that to change, use a simple fixed-price model. If the price varies depending on the number of users or units, you can use volume-based or tier-based prices. For a complete list of available models and a detailed description of each one, see examples of pricing models.

Set up webhook endpoints to receive notifications about subscription-related events. For example, when you see the invoice.paid=true notification, you can safely provision access to your service. See the subscription lifecycle for more information about webhook events. See a complete list of subscription-related events. To learn about managing access to your product’s feature, see Entitlements.