## Stripe Subscriptions: A Comprehensive Guide

This documentation set provides a deep dive into Stripe's Subscriptions product, covering everything from initial integration design to advanced management of recurring billing. Whether you're building a new SaaS product or migrating an existing one, these resources will guide you through setting up, customizing, and optimizing your subscription offerings.

### Core Concepts and Setup

*   **How subscriptions work:** Understand the fundamental lifecycle of a subscription, from creation to renewal and cancellation. This page ([/billing/subscriptions/overview](/billing/subscriptions/overview)) lays the groundwork for all subscription-related functionalities.
*   **Design a subscriptions integration:** Before diving into code, learn about the key decisions you'll need to make regarding pricing models, checkout flows, and payment timing ([/billing/subscriptions/design-an-integration](/billing/subscriptions/design-an-integration)).
*   **Build a subscriptions integration:** This guide offers a step-by-step approach to creating a functional subscription integration, covering product catalog setup, customer registration, and payment collection ([/billing/subscriptions/build-subscriptions](/billing/subscriptions/build-subscriptions)).
*   **Quickstart: Build a pre-built subscription page with Stripe Checkout:** For a faster path to implementation, this quickstart focuses on leveraging Stripe Checkout for a streamlined subscription setup ([/billing/quickstart](/billing/quickstart)).

### Pricing and Product Management

*   **Recurring pricing models:** Explore the various pricing strategies available for subscriptions, including flat rate, per-seat, tiered, and usage-based models ([/products-prices/pricing-models](/products-prices/pricing-models)).
*   **Set up flat rate pricing:** Learn how to configure a simple, fixed-price subscription plan ([/subscriptions/pricing-models/flat-rate-pricing](/subscriptions/pricing-models/flat-rate-pricing)).
*   **Set up per-seat pricing:** Understand how to charge customers based on the number of users or licenses they require ([/subscriptions/pricing-models/per-seat-pricing](/subscriptions/pricing-models/per-seat-pricing)).
*   **Embeddable pricing table for subscriptions:** Discover how to create and embed a visually appealing pricing table on your website that directs customers to Stripe Checkout ([/payments/checkout/pricing-table](/payments/checkout/pricing-table)).

### Subscription Lifecycle Management

*   **Entitlements:** Learn how to map product features to subscription status, enabling automatic granting or revoking of access ([/billing/entitlements](/billing/entitlements)).
*   **Configure trial offers on subscriptions:** Implement free or paid trial periods to attract and convert customers ([/billing/subscriptions/trials](/billing/subscriptions/trials)).
*   **Use free trial periods on subscriptions:** A specific guide on setting up free trials using legacy parameters ([/billing/subscriptions/trials/free-trials](/billing/subscriptions/trials/free-trials)).
*   **Manage compliance requirements for trials and promotions:** Ensure your trial offers meet card network requirements for customer notifications and transparency ([/billing/subscriptions/trials/manage-trial-compliance](/billing/subscriptions/trials/manage-trial-compliance)).
*   **Set the subscription billing renewal date:** Control the billing cycle anchor to align renewal dates with your business needs ([/billing/subscriptions/billing-cycle](/billing/subscriptions/billing-cycle)).
*   **Backdate subscriptions:** Learn how to bill customers for past periods, useful for migrations or record-keeping ([/billing/subscriptions/backdating](/billing/subscriptions/backdating)).
*   **Modify subscriptions:** Understand how to change existing subscriptions, including prorated charges and pending updates ([/billing/subscriptions/change](/billing/subscriptions/change)).
*   **Change the price of existing subscriptions:** Specific guidance on upgrading or downgrading subscription tiers by altering prices ([/billing/subscriptions/change-price](/billing/subscriptions/change-price)).
*   **Prorations:** Grasp the concept of prorated charges and credits when subscription details change mid-billing cycle ([/billing/subscriptions/prorations](/billing/subscriptions/prorations)).
*   **Pending updates:** Learn how to manage subscription updates that require successful payment before being applied ([/billing/subscriptions/pending-updates](/billing/subscriptions/pending-updates)).
*   **Cancel subscriptions:** Discover how to terminate subscriptions, with details on immediate effect and automatic cancellation policies ([/billing/subscriptions/cancel](/billing/subscriptions/cancel)).
*   **Pause subscriptions:** Implement a true pause of service and billing for scenarios like vacations or temporary non-usage ([/billing/subscriptions/pause](/billing/subscriptions/pause)).
*   **Pause payment collection:** Temporarily suspend payment collection while continuing service, often used for grace periods ([/billing/subscriptions/pause-payment](/billing/subscriptions/pause-payment)).
*   **Subscription schedules:** Automate changes to subscriptions over time, such as future start dates or phased upgrades/downgrades ([/billing/subscriptions/subscription-schedules](/billing/subscriptions/subscription-schedules)).
*   **Bill customers in advance:** Learn how to bill customers for multiple future service periods at once ([/billing/subscriptions/prebilling](/billing/subscriptions/prebilling)).
*   **Mixed interval subscriptions:** Combine subscription items with different billing periods into a single subscription ([/billing/subscriptions/mixed-interval](/billing/subscriptions/mixed-interval)).

### Payment Methods and Integrations

*   **Set up payment methods for subscriptions with no initial payment:** Handle scenarios where the first invoice doesn't require immediate payment ([/billing/subscriptions/deferred-payment](/billing/subscriptions/deferred-payment)).
*   **Set payment methods per-subscription:** Configure specific payment methods for individual subscriptions, offering greater flexibility ([/billing/subscriptions/payment-methods-setting](/billing/subscriptions/payment-methods-setting)).
*   **Integrate with third-party payment processors:** Learn how to use Stripe subscriptions and invoices with external payment processors ([/billing/subscriptions/third-party-payment-processing](/billing/subscriptions/third-party-payment-processing)).
*   **Set up a subscription with ACH Direct Debit:** Integrate US bank account payments for subscriptions ([/billing/subscriptions/ach-debit](/billing/subscriptions/ach-debit)).
*   **Set up a subscription with Amazon Pay:** Integrate Amazon Pay for subscription payments ([/billing/subscriptions/amazon-pay](/billing/subscriptions/amazon-pay)).
*   **Set up a subscription with Bacs Direct Debit:** Integrate UK Direct Debit for subscription payments ([/billing/subscriptions/bacs-debit](/billing/subscriptions/bacs-debit)).
*   **Set up a subscription with bank transfers:** Configure subscriptions to accept payments via bank transfers ([/billing/subscriptions/bank-transfer](/billing/subscriptions/bank-transfer)).
*   **Set up a subscription with BECS Direct Debit in Australia:** Integrate Australian BECS Direct Debit for subscription payments ([/billing/subscriptions/au-becs-debit](/billing/subscriptions/au-becs-debit)).
*   **Use Boleto with subscriptions:** Integrate Boleto, a Brazilian payment voucher, for subscription payments ([/payments/boleto/set-up-subscription](/payments/boleto/set-up-subscription)).
*   **Set up a subscription with Cash App Pay:** Integrate Cash App Pay for subscription payments ([/billing/subscriptions/cash-app-pay](/billing/subscriptions/cash-app-pay)).
*   **Set up a subscription with iDEAL and SEPA Direct Debit:** Combine iDEAL and SEPA Direct Debit for subscription payments ([/billing/subscriptions/ideal](/billing/subscriptions/ideal)).
*   **Set up a subscription with Kakao Pay:** Integrate Kakao Pay for subscription payments ([/billing/subscriptions/kakao-pay](/billing/subscriptions/kakao-pay)).
*   **Set up a subscription with Klarna:** Integrate Klarna for subscription payments ([/billing/subscriptions/klarna](/billing/subscriptions/klarna)).
*   **Set up a subscription with local South Korean cards:** Integrate local Korean card payments for subscriptions ([/billing/subscriptions/kr-card](/billing/subscriptions/kr-card)).
*   **Set up a subscription with Naver Pay:** Integrate Naver Pay for subscription payments ([/billing/subscriptions/naver-pay](/billing/subscriptions/naver-pay)).
*   **Set up a subscription with Nigerian cards:** Integrate Nigerian card payments for subscriptions ([/billing/subscriptions/ng-card](/billing/subscriptions/ng-card)).
*   **Accept subscription payments with PayTo:** Integrate PayTo for subscription payments in Australia ([/billing/subscriptions/payto](/billing/subscriptions/payto)).
*   **Set up a subscription with PayPal:** Integrate PayPal for subscription payments ([/billing/subscriptions/paypal](/billing/subscriptions/paypal)).
*   **Set up a subscription with Pix:** Integrate Pix, a Brazilian instant payment system, for subscription payments ([/billing/subscriptions/pix](/billing/subscriptions/pix)).
*   **Set up a subscription with pre-authorized debit in Canada:** Integrate Canadian pre-authorized debit for subscription payments ([/billing/subscriptions/au-becs-debit](/billing/subscriptions/au-becs-debit)).
*   **Set up a subscription with Revolut Pay:** Integrate Revolut Pay for subscription payments ([/billing/subscriptions/revolut-pay](/billing/subscriptions/revolut-pay)).
*   **Set up a subscription with SEPA Direct Debit:** Integrate SEPA Direct Debit for subscription payments in the EU ([/billing/subscriptions/sepa-debit](/billing/subscriptions/sepa-debit)).
*   **Set up a subscription with stablecoin payments:** Integrate stablecoin payments for subscriptions ([/billing/subscriptions/stablecoins](/billing/subscriptions/stablecoins)).
*   **Set up a subscription with TWINT:** Integrate TWINT for subscription payments in Switzerland ([/billing/subscriptions/twint](/billing/subscriptions/twint)).

### Migration and Advanced Topics

*   **Migrate subscriptions to Stripe Billing:** Learn about the strategies and tools for moving existing subscriptions to Stripe ([/billing/subscriptions/migrate-subscriptions](/billing/subscriptions/migrate-subscriptions)).
*   **Migrate subscriptions to Stripe Billing using toolkit:** Utilize the Stripe Dashboard toolkit for a code-free subscription migration ([/billing/subscriptions/import-subscriptions-toolkit](/billing/subscriptions/import-subscriptions-toolkit)).
*   **Migrate subscriptions to Stripe Billing using Stripe APIs:** Import subscriptions programmatically using Stripe's APIs ([/billing/subscriptions/import-subscriptions](/billing/subscriptions/import-subscriptions)).
*   **Using webhooks with subscriptions:** Understand how to use webhooks to receive real-time notifications about subscription events ([/billing/subscriptions/webhooks](/billing/subscriptions/webhooks)).
*   **Compare classic and flexible billing mode:** Learn the differences between Stripe's billing modes and choose the best fit for your integration ([/billing/subscriptions/billing-mode/compare](/billing/subscriptions/billing-mode/compare)).
*   **Enable increased flexibility for subscriptions:** Understand the benefits of flexible billing mode and how to enable it ([/billing/subscriptions/billing-mode](/billing/subscriptions/billing-mode)).
*   **Script language definition:** Explore the syntax and semantics of Stripe's scripting language used in Billing Automations ([/billing/scripts/script-language](/billing/scripts/script-language)).
*   **Integrate a SaaS business on Stripe:** A broader guide on building a SaaS business with Stripe, encompassing subscriptions and other products ([/saas](/saas)).
*   **Manage subscriptions on iOS:** Learn how to manage subscriptions and entitlements within your iOS application using the Stripe SDK ([/billing/subscriptions/manage-ios](/billing/subscriptions/manage-ios)).