## Managing Stripe Subscriptions

This documentation section provides a comprehensive guide to setting up, managing, and optimizing your Stripe subscription integrations. It covers everything from the fundamentals of how subscriptions work to advanced configurations and integrations with various payment methods.

### Core Subscription Management

*   **How subscriptions work:** Understand the lifecycle of a subscription, from creation to renewal, and the key features Stripe offers for managing recurring payments.
*   **Build a subscriptions integration:** Learn the essential steps to create and manage subscriptions, including product catalog setup, customer registration, payment collection, and monitoring.
*   **Design a subscriptions integration:** Explore different pricing models (flat rate, per-seat, tiered, usage-based) and checkout strategies to best suit your business needs.
*   **Entitlements:** Discover how to map your product features to Stripe products and use entitlements to automatically grant or revoke customer access based on their subscription status.
*   **Set the subscription billing renewal date:** Configure billing cycle anchors to align your subscription billing periods precisely.
*   **Modify subscriptions:** Learn how to update existing subscriptions, including changing prices, quantities, and billing periods, and understand the impact on billing and prorations.
*   **Cancel subscriptions:** Understand the process of canceling subscriptions, including immediate cancellations and automatic cancellations due to failed payments.
*   **Pause subscriptions:** Implement true subscription pausing, which halts both service delivery and invoice generation, ideal for scenarios like vacations or temporary non-usage.
*   **Pause payment collection:** Temporarily stop collecting payments for subscriptions, often used for grace periods or to offer services for free for a limited time.
*   **Pending updates:** Manage subscription updates that require payment, ensuring changes are only applied if the new invoice is successfully paid.
*   **Prorations:** Grasp how prorations work when subscriptions are modified, ensuring accurate charges for partial periods.
*   **Bill customers in advance:** Configure prebilling to charge customers for multiple service periods at once, either at subscription creation or for upcoming renewals.
*   **Subscription schedules:** Automate changes to subscriptions over time, allowing for future start dates, backdating, and phased upgrades/downgrades.

### Pricing and Offers

*   **Recurring pricing models:** Explore various pricing models including flat rate, per-seat, tiered, and usage-based pricing.
*   **Set up flat rate pricing:** Implement a simple pricing model where customers pay a fixed rate for a service tier.
*   **Set up per-seat pricing:** Configure pricing based on the number of users or licenses required.
*   **Configure trial offers on subscriptions:** Set up free or paid trial periods for your subscription items.
*   **Use free trial periods on subscriptions:** Learn the legacy method for implementing free trials using the `trial_end` parameter.
*   **Manage compliance requirements for trials and promotions:** Ensure compliance with card network requirements for trial offers and promotional pricing.
*   **Coupons and promotion codes:** Apply discounts to subscriptions and subscription items using coupons and promotion codes.
*   **Embeddable pricing table for subscriptions:** Create and embed a customizable pricing table on your website that links directly to Stripe Checkout.

### Billing Modes and Advanced Features

*   **Enable billing mode:** Understand and enable flexible billing mode for enhanced functionality and more accurate billing.
*   **Compare classic and flexible billing mode:** Learn the differences between billing modes to make an informed decision for your integration.
*   **Mixed interval subscriptions:** Include multiple subscription items with different prices and billing periods on a single subscription, with Stripe handling consolidated invoicing.

### Payment Methods and Integrations

*   **Set up payment methods for subscriptions 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 for increased flexibility.
*   **Set up a subscription with ACH Direct Debit:** Integrate US bank account payments for subscriptions.
*   **Set up a subscription with Amazon Pay:** Enable Amazon Pay for recurring subscription payments.
*   **Set up a subscription with Bacs Direct Debit:** Integrate UK Direct Debit payments for subscriptions.
*   **Set up a subscription with bank transfers:** Configure subscriptions to accept payments via bank transfers.
*   **Set up a subscription with BECS Direct Debit in Australia:** Integrate Australian Direct Debit payments for subscriptions.
*   **Use Boleto with subscriptions:** Implement Boleto, a Brazilian payment voucher, for subscription payments.
*   **Set up a subscription with Cash App Pay:** Integrate Cash App Pay for recurring subscription payments.
*   **Set up a subscription with iDEAL and SEPA Direct Debit:** Combine iDEAL for initial payment details with SEPA Direct Debit for recurring payments.
*   **Set up a subscription with Kakao Pay:** Integrate Kakao Pay for recurring subscription payments.
*   **Set up a subscription with Klarna:** Enable Klarna for subscription payments.
*   **Set up a subscription with local South Korean cards:** Integrate local card payments for subscriptions in South Korea.
*   **Set up a subscription with Naver Pay:** Integrate Naver Pay for recurring subscription payments.
*   **Set up a subscription with PayPal:** Enable PayPal for recurring subscription payments.
*   **Set up a subscription with PayTo:** Integrate PayTo for subscription payments.
*   **Set up a subscription with Pix:** Implement Pix, a Brazilian instant payment system, for subscriptions.
*   **Set up a subscription with pre-authorized debit in Canada:** Integrate Canadian pre-authorized debit for subscription payments.
*   **Set up a subscription with Revolut Pay:** Enable Revolut Pay for recurring subscription payments.
*   **Set up a subscription with SEPA Direct Debit:** Integrate SEPA Direct Debit for recurring payments in the EU.
*   **Set up a subscription with stablecoin payments:** Accept recurring stablecoin payments from customer crypto wallets.
*   **Set up a subscription with TWINT:** Integrate TWINT for subscription payments.
*   **Integrate with third-party payment processors:** Learn how to use Stripe subscriptions and invoices with external payment processors.

### Migration and Advanced Topics

*   **Migrate subscriptions to Stripe Billing:** Understand the process of moving existing subscriptions to Stripe Billing, whether from third-party systems, in-house solutions, or other Stripe accounts.
*   **Migrate subscriptions to Stripe Billing using toolkit:** Utilize the Stripe Dashboard's migration toolkit for a no-code migration.
*   **Migrate subscriptions to Stripe Billing using Stripe APIs:** Import subscriptions programmatically using Stripe APIs.
*   **Using webhooks with subscriptions:** Configure webhook endpoints to receive real-time notifications about subscription events and manage asynchronous activities.
*   **Manage subscriptions on iOS:** Implement subscription management and entitlement gating within your iOS applications using the Billing SDK.
*   **Script language definition:** Understand the syntax and semantics of Stripe's scripting language, a subset of TypeScript, used for advanced billing logic.
*   **Integrate a SaaS business on Stripe:** Learn how to leverage Stripe Billing and other products to build and manage a Software as a Service business.