Documentation

Start integrating Stripe’s products and tools.

From the blog

Subscriptions

Build and manage every aspect of your recurring billing with Stripe’s APIs.

An autopilot for billing

We’ve built best practices for subscriptions into our defaults—while still giving you full control and flexibility.

  • Recurring billing run right

    Just attach customers to plans, and Stripe takes care of billing them every month (or week, day, or year).

  • Let Stripe do the math

    If a user changes their subscription mid-month, we’ll automatically work out how much they owe.

Every billing model

Stripe integrates with even the most tricky subscription models.

Browse the docs for more info on all subscription features.

  • Metered billing

    Stripe helps automate complicated calculations to support usage-based plans that vary in price each month.

  • Per-seat pricing

    Easily work with plans that have a base price and per-user amount—we’ll handle any quantity changes automatically.

  • Add-ons and options

    Offer optional add-ons and let your customers customize their subscriptions.

  • Multiple subscriptions per customer

    You can subscribe a single customer to multiple plans simultaneously.

Store your customers’ billing info with Stripe

Securely keep payment info on file so that you can renew subscriptions or upgrade your user’s plan, all without needing to worry about PCI compliance. Learn more

A toolkit to reach new users

Once you’ve got subscriptions set up, we’ve built tools into our API to help you reach new audiences, experiment with discounts, and maximize renewals.

  • Target new users with discounts and trials

    Build trial periods into your plans to let users preview your service, or use coupons to easily test the impact of different discounts.

  • Go international

    You can set up plans in 139 currencies, increasing conversions right out of the box. If you’d like to accept Bitcoin, Alipay, or ACH transfers, just shoot us a note.

  • Smart retry logic

    We help you minimize failed payments by testing and defaulting to the ideal retry logic. You can also tweak and customize your preferences in your dashboard.

  • Smarter saved cards

    Your stored cards will continue to work even if the card number or expiry date changes—Stripe works directly with card networks so that your customers can continue using your service without interruption.

Fits within your workflow

Customize the experience for your users from start to finish—our flexible APIs map to every step in a subscription.

  • Create
    plans
  • Sign up a
    customer
  • Handle an upgrade
  • Add extra
    seats
  • Renew a subscription
curl https://api.stripe.com/v1/plans \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -d amount=2000 \
  -d interval=month \
  -d id=gold \
  -d currency=usd \
  -d name="Amazing Gold Plan"

curl https://api.stripe.com/v1/customers \
  -u sk_test_BQokikJOvBiI2HlWgH4olfQ2: \
  -d "description=Customer for [email protected]" \
  -d card=tok_14d5c12eZvKYlo2CIrrKegI5 \
  -d plan=gold

curl https://api.stripe.com/v1/subscriptions/sub_4mfbITPzBUijjX \
  -u sk_test_jId8tWpQJuUpj7dtRQnkyH3t: \
  -d plan=platinum

curl https://api.stripe.com/v1/subscriptions/sub_4mfbITPzBUijjX \
  -u sk_test_jId8tWpQJuUpj7dtRQnkyH3t: \
  -d plan=golden_seat \
  -d quantity=26

Create different plans

You can set up an unlimited number of plans either via the API or the Dashboard. Try it out.

Sign up a customer

You can create customer objects to save a user’s payment info securely. Once you have plans and customers, you can subscribe them to a plan.

Handle an upgrade

If your users want to switch a plan (or change their billing cycle), Stripe takes care of figuring out how much they owe, even if it’s in the middle of a month.

Add seats

If you have plans which need to take the number of users into account, just update the quantity of the plan.

Stripe automatically handles renewals

Once you’ve added a customer to a plan, Stripe automatically handles charging your user based on the billing cycle you’ve set up.

  • Keep your business and Stripe in sync

    Webhooks notify you about events that happen in your account. For example, we’ll fire the invoice.payment_succeeded event when a customer is charged for a subscription. You can use webhooks to trigger emails, shipments, changes to user permissions, and more.

  • Unified dashboard

    If you create one-off charges, they’ll show up alongside any recurring payments in the Dashboard.

Endless possibilities

You can do more with your data—everything from building cohort analyses to tracking churn.

  • Track everything

    Store relevant info with metadata (color, sizing, shipping status, or account IDs) to track data across all your products.

  • Easy exports

    All your data is accessible via the API. You can also download CSVs or export your charges directly to Quickbooks and other systems.

Third-party apps

Stripe integrates with hundreds of services to give you extra features and insights about your business.

See more services