## Stripe Subscriptions Documentation

This documentation set covers the comprehensive management of subscriptions within the Stripe platform. It details how to set up, configure, and manage recurring payments for your products and services.

### Core Concepts & Setup

*   **How subscriptions work:** Understand the fundamental principles of subscriptions, including recurring payments, customer information management, and the subscription lifecycle.
*   **Build a subscriptions integration:** A general guide to creating and managing subscriptions for recurring payments, covering product catalog setup, customer registration, payment collection, and monitoring.
*   **Design a subscriptions integration:** Explore the various configuration options and pricing models (flat rate, per-seat, tiered, usage-based) available for your subscription integration.
*   **Recurring pricing models:** Detailed explanations of different pricing strategies like flat rate, per-seat, tiered, and usage-based pricing.
*   **Set up flat rate pricing:** Guidance on implementing a straightforward pricing model where customers pay a fixed rate for a service tier.
*   **Set up per-seat pricing:** Instructions for setting up pricing based on the number of users or licenses.
*   **Embeddable pricing table for subscriptions:** Learn how to create and embed a customizable pricing table on your website that directs customers to Stripe Checkout.

### Subscription Management & Features

*   **Entitlements:** Manage customer access to product features based on their subscription status.
*   **Billing Cycle:** Configure the renewal date for subscriptions, aligning with recurring intervals and billing cycle anchors.
*   **Trials:** Set up free or paid trial periods for subscription items to qualify leads and reduce trial abuse.
    *   **Configure trial offers on subscriptions:** General guidance on managing trial periods.
    *   **Use free trial periods on subscriptions:** Specific instructions for implementing free trials using legacy parameters.
    *   **Manage compliance requirements for trials and promotions:** Ensure compliance with card network requirements for trial offers.
*   **Billing Modes:**
    *   **Enable increased flexibility for subscriptions:** Understand and enable "flexible" billing mode for enhanced functionality.
    *   **Compare classic and flexible billing mode:** Detailed comparison to help you choose the appropriate billing mode.
*   **Prorations:** Manage prorated charges and credits when subscriptions are modified.
*   **Modify subscriptions:** Learn how to change existing subscriptions, including price adjustments, prorations, and pending updates.
    *   **Pending updates:** Handle payment failures when updating subscriptions.
    *   **Change the price of existing subscriptions:** Upgrade or downgrade subscriptions by changing their prices.
*   **Cancel subscriptions:** Procedures for manually canceling customer subscriptions.
*   **Pause subscriptions:** Temporarily suspend 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 future service periods.
*   **Subscription schedules:** Automate changes to subscriptions over time, such as future start dates or upgrades/downgrades.
*   **Mixed interval subscriptions:** Include multiple subscription items with different intervals on a single subscription.
*   **Coupons and promotion codes:** Apply discounts to subscriptions and subscription items.
*   **Set product or subscription quantities:** Subscribe customers to multiple products or quantities of a single product on one invoice.

### Migration & Integrations

*   **Migrate subscriptions to Stripe Billing:** An overview of migrating subscriptions from various sources.
    *   **Migrate subscriptions using a toolkit:** Use the Stripe Dashboard toolkit for code-free migration.
    *   **Migrate subscriptions using Stripe APIs:** Import subscriptions using custom scripts and Stripe APIs.
*   **Integrate with third-party payment processors:** Learn how to use Stripe subscriptions and invoices with external payment processors.

### Payment Methods for Subscriptions

This section details how to set up subscriptions with various payment methods:

*   **Set up payment methods for subscriptions with no initial payment:** Authorize and store payment methods for future payments when no upfront charge is required.
*   **Set payment methods per-subscription:** Specify available payment methods for individual subscriptions.
*   **Set up a subscription with ACH Direct Debit:** For 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:** For 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:** For Australian Direct Debit payments.
*   **Use Boleto with subscriptions:** Integrate Boleto as a payment method 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 details with 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:** Accept payments via local Korean cards.
*   **Set up a subscription with Naver Pay:** Integrate Naver Pay for subscription payments.
*   **Set up a subscription with Nigerian cards:** Accept payments via Naira cards.
*   **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 pre-authorized debit in Canada:** For Canadian pre-authorized debit payments.
*   **Set up a subscription with Revolut Pay:** Integrate Revolut Pay for subscription payments.
*   **Set up a subscription with SEPA Direct Debit:** For EU SEPA Direct Debit payments.
*   **Set up a subscription with stablecoin payments:** Accept recurring stablecoin payments.
*   **Set up a subscription with TWINT:** Integrate TWINT for subscription payments.

### Advanced Topics & Tools

*   **Script language definition:** Understand the syntax and semantics of the scripting language used in Stripe Billing.
*   **Using webhooks with subscriptions:** Configure webhook endpoints to receive notifications of subscription activity.
*   **Manage subscriptions on iOS:** Utilize the Billing SDK for iOS to manage subscriptions and entitlements within your app.
*   **Quickstart:** Build a pre-built subscription page with Stripe Checkout.