## Stripe Subscriptions Documentation

This documentation covers the comprehensive features and functionalities of Stripe's subscription management system. It guides users through setting up, managing, and optimizing recurring billing for their businesses.

### Core Concepts

*   **Subscriptions Overview**: Understand the fundamental concepts of how subscriptions work with Stripe, including recurring payments, customer information storage, and various features for managing subscription billing.
*   **Pricing Models**: Explore different pricing models available for subscriptions, such as flat-rate, per-seat, tiered, and usage-based pricing.
*   **Entitlements**: Learn how to map product features to Stripe products and manage customer access to these features based on their subscription status.

### Building and Managing Subscriptions

*   **Design an Integration**: Get guidance on the key decisions to make when designing a subscriptions integration, including charging methods and checkout experiences.
*   **Build an Integration**: Step-by-step guides for creating a subscriptions integration, covering product catalog, customer registration, payment collection, and ongoing management.
*   **Recurring Pricing Models**: Detailed guides on setting up specific recurring pricing models:
    *   Flat Rate Pricing
    *   Per-Seat Pricing
    *   Tiered Pricing
    *   Usage-Based Pricing
*   **Embeddable Pricing Table**: Learn how to create and embed a pricing table on your website to display subscription options and direct customers to checkout.
*   **Collect a Payment Method with No Initial Payment**: Set up payment methods for subscriptions that don't require an immediate charge, often used for free trials or usage-based billing.
*   **Configure Trial Offers**: Implement free or paid trial periods for subscription items to qualify leads and reduce trial abuse.
    *   Use Free Trial Periods
    *   Manage Compliance Requirements for Trials and Promotions
*   **Set Billing Cycles**: Understand and configure the billing cycle anchor to align future billing period dates for subscriptions.
*   **Enable Billing Mode**: Choose between "classic" and "flexible" billing modes to optimize invoice generation and access new features.
    *   Compare Classic and Flexible Billing Mode
*   **Use Mixed Interval Subscriptions**: Include multiple subscription items with different prices and billing periods on a single subscription for consolidated invoicing.
*   **Apply Coupons**: Learn how to use coupons and promotion codes to offer discounts on subscriptions and subscription items.
*   **Modify Subscriptions**: Manage changes to existing subscriptions, including prorated charges, credits, and pending updates.
    *   Change Prices of Existing Subscriptions
    *   Manage Prorations
    *   Pending Updates
*   **Cancel Subscriptions**: Understand how to cancel customer subscriptions, with options for immediate cancellation or cancellation at the end of the period.
*   **Pause Subscriptions**: Temporarily suspend both service delivery and invoice generation for subscriptions.
*   **Pause Payment Collection**: Temporarily stop collecting payments for subscriptions, often used for grace periods.
*   **Bill Customers in Advance**: Utilize prebilling to charge customers for multiple service periods at once.
*   **Subscription Schedules**: Automate changes to subscriptions over time by defining phases for future modifications.
*   **Backdate Subscriptions**: Learn how to backdate subscriptions to bill customers for past elapsed time.

### Payment Methods for Subscriptions

*   **Set Payment Methods Per-Subscription**: Configure specific payment methods available for individual subscriptions.
*   **Integrate with Third-Party Payment Processors**: Use Stripe subscriptions and invoices with off-Stripe payment processors.
*   **Local Payment Methods**: Guides for setting up subscriptions with various local payment methods:
    *   ACH Direct Debit (US)
    *   Amazon Pay
    *   Bacs Direct Debit (UK)
    *   Bank Transfers
    *   BECS Direct Debit (Australia)
    *   Boleto (Brazil)
    *   Cash App Pay
    *   iDEAL with SEPA Direct Debit
    *   Kakao Pay (South Korea)
    *   Klarna
    *   Local South Korean Cards
    *   Naver Pay (South Korea)
    *   PayTo (Australia)
    *   PayPal
    *   Pix (Brazil)
    *   Pre-authorized Debit (Canada)
    *   Revolut Pay
    *   SEPA Direct Debit (EU)
    *   Stablecoin Payments
    *   TWINT (Switzerland)
    *   Nigerian Cards

### Migration and Advanced Topics

*   **Migrate Subscriptions to Stripe Billing**: Learn how to import existing subscriptions from third-party systems, in-house systems, or other Stripe accounts.
    *   Migrate Subscriptions Using a Toolkit
    *   Migrate Subscriptions Using Stripe APIs
*   **Using Webhooks with Subscriptions**: Understand how to use webhook events to receive notifications of subscription activity and manage asynchronous processes.
*   **Manage Subscriptions on iOS**: Utilize the Billing SDK for iOS to accept subscription payments and manage entitlements within your iOS app.
*   **Script Language Definition**: Learn about the syntax and semantics of the scripting language used in Stripe Billing for advanced automation.
*   **Integrate a SaaS Business on Stripe**: Guidance on building a Software as a Service (SaaS) business with Stripe Billing and other Stripe products.