## Stripe Subscriptions Documentation

This documentation covers the comprehensive features and functionalities of Stripe Subscriptions, a powerful tool for managing recurring payments and customer billing.

### Core Concepts

*   **Subscriptions Overview:** Understand the fundamental principles of how subscriptions work with Stripe, including recurring payments, customer information management, and key features like discount management, trial periods, and automated revenue recovery.
*   **Pricing Models:** Explore various pricing models to suit different business needs, including:
    *   **Flat Rate Pricing:** Charge a fixed price for a service tier.
    *   **Per-Seat Pricing:** Charge based on the number of users or licenses.
    *   **Tiered Pricing:** Offer varying costs based on quantity or usage.
    *   **Usage-Based Pricing:** Bill customers based on their actual consumption of a product or service.
*   **Products and Prices:** Learn how to define what you sell (Products) and how much and how often to charge for them (Prices).

### Building Your Subscription Integration

*   **Design an Integration:** Get guidance on the essential design decisions for your subscription integration, including how to charge customers, manage checkout flows, and determine payment timing.
*   **Build an Integration:** Step-by-step guides for creating a functional subscription integration, covering product catalog setup, customer registration, payment collection, and monitoring.
*   **Quickstart:** A streamlined introduction to getting started with subscriptions using Stripe Billing and Stripe Checkout.
*   **Embeddable Pricing Table:** Easily display your subscription pricing on your website and direct customers to Stripe Checkout.

### Subscription Management

*   **Manage Subscriptions:** Comprehensive documentation on managing the lifecycle of subscriptions, including:
    *   **Modifying Subscriptions:** Update existing subscriptions to cancel, pause, apply prorated charges, and more, without needing to recreate them.
    *   **Canceling Subscriptions:** Learn how to cancel subscriptions through the API or Dashboard, with options for immediate cancellation or cancellation at the end of the billing period.
    *   **Pausing Subscriptions:** Temporarily suspend service delivery and invoice generation for subscriptions.
    *   **Pausing Payment Collection:** Halt payment collection for a subscription while continuing service and invoice generation.
    *   **Backdating Subscriptions:** Bill customers for past usage or periods.
    *   **Subscription Schedules:** Automate changes to subscriptions over time, such as future start dates or upgrades/downgrades.
*   **Billing Cycles:** Configure the renewal date for your subscriptions to align with your business needs.
*   **Trial Offers:** Set up free or paid trial periods for your subscription items.
*   **Entitlements:** Map your internal service features to Stripe products to automatically grant or revoke customer access based on their subscription status.

### Billing Modes and Invoicing

*   **Enable Billing Mode:** Understand and enable flexible billing mode for enhanced functionality and access to new features.
    *   **Compare Classic and Flexible Billing Mode:** Learn the differences between the two billing modes to make an informed decision for your integration.
*   **Bill Customers in Advance (Prebilling):** Bill customers for multiple service periods at once.
*   **Prorations:** Manage prorated charges and credits when subscription details are modified.
*   **Pending Updates:** Handle payment failures when updating subscriptions, ensuring changes are applied only after successful payment.
*   **Subscription Invoices:** Configure how invoices are generated and managed for your subscriptions.

### Payment Methods and Options

*   **Collect Payment Method with No Initial Payment:** Authorize and store payment methods for subscriptions that don't require an immediate charge.
*   **Set Payment Methods Per-Subscription:** Specify available payment methods for individual subscriptions.
*   **Mixed Interval Subscriptions:** Include multiple subscription items with different intervals on a single subscription for consolidated invoicing.
*   **Coupons and Promotion Codes:** Apply discounts to subscriptions and subscription items.
*   **Supported Payment Methods:** Detailed guides on setting up subscriptions with various payment methods, including:
    *   ACH Direct Debit
    *   Amazon Pay
    *   Bacs Direct Debit (UK)
    *   Bank Transfers
    *   BECS Direct Debit (Australia)
    *   Boleto
    *   Cash App Pay
    *   iDEAL
    *   Kakao Pay
    *   Klarna
    *   Local South Korean Cards
    *   Naver Pay
    *   Nigerian Cards
    *   PayPal
    *   PayTo
    *   Pix
    *   Pre-authorized Debit (Canada)
    *   Revolut Pay
    *   SEPA Direct Debit (EU)
    *   Stablecoins
    *   TWINT

### Migration and Integrations

*   **Migrate Subscriptions to Stripe Billing:** Learn how to import existing subscriptions from other systems or Stripe accounts.
    *   **Migrate Subscriptions using Toolkit:** Utilize the Billing migration toolkit for a no-code migration process.
    *   **Migrate Subscriptions using Stripe APIs:** Import subscriptions programmatically using Stripe APIs.
*   **Integrate with Third-Party Payment Processors:** Use Stripe subscriptions and invoices with external payment processors.
*   **Manage Subscriptions on iOS:** Integrate subscription management and entitlements directly into your iOS app.

### Advanced Features

*   **Webhooks with Subscriptions:** Receive notifications of subscription activity to manage your subscriptions asynchronously.
*   **Script Language Definition:** Understand the syntax and semantics of the scripting language used in Stripe Billing for advanced automation.