## Stripe Subscriptions Documentation

This documentation set provides comprehensive guidance on implementing and managing subscriptions with Stripe. It covers everything from the fundamental concepts of how subscriptions work to advanced configuration options, various pricing models, and integration with a wide range of payment methods.

### Core Concepts & Getting Started

*   **How subscriptions work:** Understand the lifecycle of a subscription, from creation to renewal and cancellation, and the key features Stripe offers for managing recurring payments.
*   **Build a subscriptions integration:** A foundational guide to creating and managing subscriptions, including product catalog setup, customer registration, payment collection, and monitoring.
*   **Design a subscriptions integration:** Explore different strategies for charging customers, checkout flows, and payment timing to best suit your business model.
*   **Quickstart:** Get up and running quickly with a pre-built subscription page using Stripe Checkout.

### Subscription Management & Features

*   **Entitlements:** Learn how to map product features to subscription statuses, enabling automatic provisioning and de-provisioning of access.
*   **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 products to attract and convert customers.
*   **Coupons and Promotion Codes:** Apply discounts to subscriptions and subscription items to incentivize purchases.
*   **Modify Subscriptions:** Understand how to change existing subscriptions without needing to cancel and recreate them, including handling prorations and pending updates.
*   **Cancel Subscriptions:** Learn the process for canceling customer subscriptions, including automatic cancellation after failed payment attempts.
*   **Pause Subscriptions:** Temporarily suspend service delivery and invoice generation for subscriptions.
*   **Pause Payment Collection:** Allow customers a grace period for payment without interrupting service or invoice generation.
*   **Subscription Schedules:** Automate changes to subscriptions over time, such as starting on a future date or backdating.
*   **Backdate Subscriptions:** Bill customers for past periods, useful for migrations or record-keeping.
*   **Prorations:** Understand how Stripe calculates charges for partial periods when subscriptions are modified.
*   **Pending Updates:** Manage payment failures when updating subscriptions to ensure changes are applied correctly.
*   **Bill Customers in Advance:** Configure prebilling to charge customers for multiple service periods at once.
*   **Mixed Interval Subscriptions:** Include multiple subscription items with different billing periods on a single subscription.
*   **Set Product or Subscription Quantities:** Subscribe customers to multiple products or quantities of a single product, billed on one invoice.

### Pricing Models

*   **Recurring Pricing Models:** Explore various pricing strategies for subscriptions, 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:** Charge customers based on their actual consumption of your product or service.

### Payment Methods & Integrations

*   **Embeddable Pricing Table:** Create and embed a customizable pricing table on your website that links to Stripe Checkout.
*   **Set up Payment Methods for Subscriptions with No Initial Payment:** Handle scenarios where an initial charge isn't required, such as free trials.
*   **Billing Mode:** Understand and enable flexible billing mode for enhanced functionality and predictable billing.
    *   **Compare Classic and Flexible Billing Mode:** Learn the differences and choose the best mode for your integration.
*   **Payment Methods:** Integrate a wide range of payment methods for subscriptions:
    *   ACH Direct Debit
    *   Amazon Pay
    *   Bacs Direct Debit (UK)
    *   Bank Transfers
    *   BECS Direct Debit (Australia)
    *   Boleto
    *   Cash App Pay
    *   iDEAL with SEPA Direct Debit
    *   Kakao Pay
    *   Klarna
    *   Local South Korean Cards
    *   Naver Pay
    *   Nigerian Cards
    *   PayPal
    *   PayTo
    *   Pix
    *   Pre-authorized Debit (Canada)
    *   Revolut Pay
    *   SEPA Direct Debit (EU)
    *   Stablecoin Payments
    *   TWINT

### Migration & Advanced Topics

*   **Migrate Subscriptions to Stripe Billing:** Learn how to import existing subscriptions using the toolkit or Stripe APIs.
*   **Using Webhooks with Subscriptions:** Configure webhook endpoints to receive notifications of subscription activity.
*   **Manage Subscriptions on iOS:** Integrate Stripe Billing SDK for iOS to manage subscriptions and entitlements within your app.
*   **Integrate with Third-Party Payment Processors:** Utilize Stripe subscriptions and invoices with external payment processors.
*   **Entitlements:** Determine when to grant or revoke product feature access based on subscription status.