## Stripe Subscriptions: A Comprehensive Guide

This documentation set provides a detailed overview of Stripe's subscription management capabilities. It covers everything from the fundamental concepts of how subscriptions work to advanced features like flexible billing, prorations, and integrating with various payment methods.

### Core Concepts and Setup

*   **How subscriptions work:** Understand the lifecycle of a subscription, from creation to renewal, and the key features Stripe offers to manage 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 tailor your subscription offerings.
*   **Recurring pricing models:** Dive deeper into the various pricing models available for subscriptions and how to implement them.
    *   **Set up flat rate pricing:** Configure subscriptions with fixed pricing tiers.
    *   **Set up per-seat pricing:** Implement pricing based on the number of users or seats.
    *   **Set up usage-based pricing:** Charge customers based on their actual consumption of a service.
    *   **Set up tiered pricing:** Offer pricing that varies based on quantity or usage tiers.
*   **Embed a pricing table:** Learn how to create and embed a visually appealing pricing table on your website that links directly to Stripe Checkout.

### Subscription Management and Lifecycle

*   **Entitlements:** Understand how to map product features to Stripe products and manage customer access based on their subscription status.
*   **Billing cycles:** Configure the renewal dates for your subscriptions to align with your business needs.
*   **Trial offers:** Set up free or paid trial periods for your subscription products to attract new customers.
    *   **Use free trial periods:** Implement free trials using legacy parameters.
    *   **Manage compliance requirements for trials and promotions:** Ensure compliance with card network rules for trial offers.
*   **Billing modes:**
    *   **Enable increased flexibility for subscriptions:** Understand the benefits of flexible billing mode for enhanced functionality.
    *   **Compare classic and flexible billing mode:** Make an informed decision about which billing mode best suits your integration.
*   **Subscription schedules:** Automate changes to subscriptions over time, such as future start dates or upgrades/downgrades.
*   **Modify subscriptions:** Learn how to change existing subscriptions, including prorated charges and pending updates.
    *   **Manage prorations:** Understand how prorations are calculated for subscription modifications.
    *   **Pending updates:** Handle payment failures when updating subscriptions.
    *   **Change the price of existing subscriptions:** Upgrade or downgrade subscriptions by modifying their prices.
*   **Cancel subscriptions:** Learn how to manage subscription cancellations through the API or the Dashboard.
*   **Pause subscriptions:** Temporarily suspend service delivery and invoice generation for subscriptions.
*   **Pause payment collection:** Offer grace periods or temporarily provide services for free without affecting subscription status.
*   **Bill customers in advance:** Configure prebilling to charge customers for multiple service periods at once.
*   **Coupons and promotion codes:** Apply discounts to subscriptions and subscription items.
*   **Migrate subscriptions to Stripe Billing:** Import existing subscriptions from other systems or Stripe accounts.
    *   **Migrate subscriptions using toolkit:** Utilize the Billing migration toolkit for a no-code migration.
    *   **Migrate subscriptions using Stripe APIs:** Import subscriptions programmatically using Stripe's APIs.
*   **Using webhooks with subscriptions:** Receive real-time notifications about subscription events to manage your integration.

### Payment Methods and Integrations

*   **Collect a 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 billing periods on a single subscription.
*   **Integrate with third-party payment processors:** Use Stripe subscriptions and invoices with external payment processors.
*   **Specific Payment Method Integrations:**
    *   **Set up a subscription with ACH Direct Debit:** Integrate US bank account payments.
    *   **Set up a subscription with Amazon Pay:** Integrate Amazon Pay for subscription payments.
    *   **Set up a subscription with Bacs Direct Debit:** Integrate UK Direct Debit payments.
    *   **Set up a subscription with bank transfers:** Configure subscriptions for bank transfer payments.
    *   **Set up a subscription with BECS Direct Debit in Australia:** Integrate Australian Direct Debit payments.
    *   **Use Boleto with subscriptions:** Implement Boleto voucher payments for subscriptions.
    *   **Set up a subscription with Cash App Pay:** Integrate Cash App Pay for subscription payments.
    *   **Set up a subscription with iDEAL and SEPA Direct Debit:** Combine iDEAL for initial payment and SEPA Direct Debit for recurring payments.
    *   **Set up a subscription with Kakao Pay:** Integrate Kakao Pay for subscription payments.
    *   **Set up a subscription with Klarna:** Integrate Klarna for subscription payments.
    *   **Set up a subscription with local South Korean cards:** Integrate local card payments in South Korea.
    *   **Set up a subscription with Naver Pay:** Integrate Naver Pay for subscription payments.
    *   **Set up a subscription with Nigerian cards:** Integrate Naira card payments in Nigeria.
    *   **Set up a subscription with PayPal:** Integrate PayPal for subscription payments.
    *   **Accept subscription payments with PayTo:** Integrate PayTo for subscription payments.
    *   **Set up a subscription with Pix:** Integrate Pix for subscription payments.
    *   **Set up a subscription with Revolut Pay:** Integrate Revolut Pay for subscription payments.
    *   **Set up a subscription with SEPA Direct Debit:** Integrate SEPA Direct Debit payments in the EU.
    *   **Set up a subscription with stablecoin payments:** Integrate stablecoin payments.
    *   **Set up a subscription with TWINT:** Integrate TWINT for subscription payments.
*   **Manage subscriptions on iOS:** Utilize the Billing SDK for iOS to manage subscriptions and entitlements within your app.

### Advanced Topics

*   **Backdate subscriptions:** Bill customers for past service periods.
*   **Script language definition:** Understand the syntax and semantics of Stripe Billing's scripting language.
*   **Integrate a SaaS business on Stripe:** Learn how to build a Software as a Service business using Stripe Billing and other products.