## Stripe Subscriptions Documentation

This documentation collection provides comprehensive guidance on implementing and managing subscriptions with Stripe. It covers everything from the fundamental concepts of how subscriptions work to advanced features like custom pricing models, entitlement management, and integration with various payment methods.

### Core Concepts & Getting Started

*   **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:** A foundational guide to creating and managing subscriptions for recurring payments, covering 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 options to tailor your subscription service to your business needs.
*   **Quickstart: Build a pre-built subscription page with Stripe Checkout:** A fast-track guide to setting up a subscription page using Stripe Checkout for a streamlined customer experience.

### Subscription Management & Features

*   **Entitlements:** Learn how to map product features to customer subscription statuses, enabling automated granting and revocation of access.
*   **Set the subscription billing renewal date:** Configure billing cycle anchors to control when subscriptions renew and invoices are generated.
*   **Modify subscriptions:** Understand how to change existing subscriptions, including prorated charges, pending updates, and the impact on billing.
*   **Cancel subscriptions:** Learn the process of canceling subscriptions, including immediate cancellation and automatic cancellation after failed payment attempts.
*   **Pause subscriptions:** Discover how to temporarily halt service delivery and invoice generation for subscriptions, useful for scenarios like vacations or non-usage.
*   **Pause payment collection:** Explore options for temporarily suspending payment collection while allowing service to continue, often used for grace periods.
*   **Backdate subscriptions:** Learn how to bill customers for past periods, useful for migrations or record-keeping.
*   **Subscription schedules:** Automate changes to subscriptions over time, such as future start dates, backdating, or upgrades/downgrades.
*   **Configure trial offers on subscriptions:** Implement free or paid trial periods to attract customers and manage promotional pricing.
*   **Use free trial periods on subscriptions:** Specific guidance on setting up free trial periods using legacy parameters.
*   **Manage compliance requirements for trials and promotions:** Ensure adherence to card network requirements for trial offers and promotions.
*   **Prorations:** Understand how partial period charges and credits are calculated when subscription details change.
*   **Pending updates:** Manage payment failures when updating subscriptions to ensure changes are applied correctly.
*   **Bill customers in advance:** Learn how to bill customers for multiple future service periods at once.
*   **Mixed interval subscriptions:** Include multiple subscription items with different billing periods on a single subscription for consolidated invoicing.
*   **Coupons and promotion codes:** Apply discounts to subscriptions and subscription items.
*   **Set product or subscription quantities:** Manage subscriptions for multiple products or multiple quantities of a single product within a single invoice.

### Pricing Models

*   **Recurring pricing models:** An overview of available pricing models for subscriptions.
*   **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:** Charge customers based on the number of users or licenses they require.
*   **Set up usage-based pricing:** Bill customers based on their actual consumption of your product or service.
*   **Set up tiered pricing:** Offer varying unit costs based on quantity or usage.
*   **Embeddable pricing table for subscriptions:** Create and embed a customizable pricing table on your website that links to Stripe Checkout.

### Billing Modes

*   **Enable increased flexibility for subscriptions:** Understand and enable "flexible billing mode" for enhanced features and more predictable billing behavior.
*   **Compare classic and flexible billing mode:** Detailed comparison of the two billing modes to help you choose the best option for your integration.

### Migrating Subscriptions

*   **Migrate subscriptions to Stripe Billing:** An overview of migrating existing subscriptions from various sources to Stripe Billing.
*   **Migrate subscriptions to Stripe Billing using toolkit:** Utilize the Billing migration toolkit for a no-code migration process.
*   **Migrate subscriptions to Stripe Billing using Stripe APIs:** Learn how to import subscriptions programmatically using Stripe APIs.

### Payment Methods & 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 greater flexibility.
*   **Integrate with third-party payment processors:** Learn how to use Stripe subscriptions and invoices with external payment processors.
*   **Set up a subscription with ACH Direct Debit:** Configure subscriptions 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 in the UK:** Configure subscriptions for UK Direct Debit payments.
*   **Set up a subscription with bank transfers:** Enable bank transfers as a payment method for subscriptions.
*   **Set up a subscription with BECS Direct Debit in Australia:** Configure subscriptions for Australian Direct Debit payments.
*   **Use Boleto with subscriptions:** Integrate Boleto, a Brazilian voucher 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 collection 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:** Enable subscription payments using local Korean cards.
*   **Set up a subscription with Naver Pay:** Integrate Naver Pay for subscription payments.
*   **Set up a subscription with Nigerian cards:** Configure subscriptions for Nigerian card payments.
*   **Accept subscription payments with PayTo:** Integrate PayTo for subscription payments.
*   **Set up a subscription with PayPal:** Integrate PayPal for subscription payments.
*   **Set up a subscription with Pix:** Integrate Pix, a Brazilian instant payment system, for subscriptions.
*   **Set up a subscription with pre-authorized debit in Canada:** Configure subscriptions 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 in the EU:** Configure subscriptions for SEPA Direct Debit payments.
*   **Set up a subscription with stablecoin payments:** Enable subscription payments using stablecoins.
*   **Set up a subscription with TWINT:** Integrate TWINT for subscription payments.

### Advanced Topics

*   **Script language definition:** Learn about the syntax and semantics of Stripe Billing's scripting language, a subset of TypeScript.
*   **Using webhooks with subscriptions:** Configure webhooks to receive real-time notifications of subscription activity and manage asynchronous events.
*   **Manage subscriptions on iOS:** Implement subscription management within your iOS applications using the Stripe Billing SDK for iOS.