# Stripe Subscriptions Documentation

This documentation suite covers the comprehensive features and functionalities of Stripe's subscription management system. It provides guidance on building, managing, and optimizing recurring billing for your business.

## Core Concepts

*   **Subscriptions Overview**: Understand the fundamental concepts of how subscriptions work with Stripe, including recurring payments, customer information management, and the subscription lifecycle.
*   **Pricing Models**: Explore various recurring pricing models such as flat-rate, per-seat, tiered, and usage-based pricing to best suit your business needs.
*   **Entitlements**: Learn how to map product features to Stripe products to automate the granting and revocation of customer access based on their subscription status.

## Building a Subscription Integration

*   **Design an Integration**: Get guidance on the key decisions to make when designing your subscription integration, covering charging methods, checkout flow, and payment timing.
*   **Build an Integration**: Step-by-step guides on creating a robust subscription integration using Stripe Billing and Checkout.
*   **Quickstart**: A streamlined path to get started with building a subscription integration.
*   **Embeddable Pricing Table**: Instructions on how to create and embed a pricing table on your website to display subscription options and direct customers to checkout.
*   **Set up Payment Methods**: Detailed guides on configuring various payment methods for subscriptions, including:
    *   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
    *   PayPal
    *   PayTo
    *   Pix
    *   Pre-authorized Debit (Canada)
    *   Revolut Pay
    *   SEPA Direct Debit (EU)
    *   Stablecoins
    *   TWINT
    *   Nigerian Cards

## Managing Subscriptions

*   **How Subscriptions Work**: A detailed explanation of the subscription lifecycle and its core components.
*   **Manage Subscriptions**: General guidance on managing customer subscriptions.
*   **Set Billing Cycles**: Learn how to define and manage the billing renewal date for your subscriptions using billing cycle anchors.
*   **Configure Trial Offers**: Set up free or paid trial periods for your subscription items to attract and convert customers.
*   **Enable Billing Mode**: Understand and configure billing modes (Classic vs. Flexible) to enhance flexibility and access new features for your subscriptions.
*   **Use Mixed Interval Subscriptions**: Combine subscription items with different billing periods into a single subscription for consolidated invoicing.
*   **Apply Coupons**: Add discounts to subscriptions and subscription items using coupons and promotion codes.
*   **Modify Subscriptions**: Learn how to change existing subscriptions, including prorated charges, credits, and pending updates.
*   **Cancel Subscriptions**: Procedures for canceling customer subscriptions.
*   **Pause Subscriptions**: Temporarily suspend subscriptions, halting both service delivery and invoice generation.
*   **Pause Payment Collection**: Temporarily stop collecting payments for subscriptions, often used for grace periods or free service offerings.
*   **Bill Customers in Advance**: Utilize prebilling to charge customers for multiple service periods at once.
*   **Manage Subscriptions on iOS**: Integrate Stripe's Billing SDK for iOS to manage subscriptions and entitlements within your iOS applications.
*   **Subscription Schedules**: Automate changes to subscriptions over time, such as future start dates or upgrades/downgrades.
*   **Backdate Subscriptions**: Bill customers for past periods by backdating subscription start dates.
*   **Prorations**: Understand how partial charges and credits are calculated when subscription details change.
*   **Set Product or Subscription Quantities**: Manage subscriptions for multiple products or multiple quantities of a single product on a single invoice.

## Advanced Features and Integrations

*   **Entitlements**: Determine when to grant or revoke product feature access to customers based on their subscription status.
*   **Subscription Invoices**: Configure how subscription invoices are generated and managed.
*   **Collect Payment Method with No Initial Payment**: Set up payment methods for subscriptions that don't require an immediate upfront charge, such as those with free trials.
*   **Migrate Subscriptions to Stripe**: Guidance on migrating existing subscriptions to Stripe Billing, using either the migration toolkit or Stripe APIs.
*   **Configure Subscription Events**: Understand and utilize webhooks to receive notifications of subscription activity and manage asynchronous events.
*   **Integrate with Third-Party Payment Processors**: Learn how to use Stripe subscriptions and invoices with external payment processors.
*   **Calculate and Collect Taxes**: Integrate Stripe Tax to automatically charge and report sales tax, VAT, and GST on subscriptions.
*   **Revenue Recovery**: Implement strategies and settings to recover revenue from failed subscription payments.
*   **Automations**: Explore automation capabilities within Stripe Billing.
*   **Scripts**: Understand the scripting language used in Stripe Billing for advanced customization.
*   **Test Your Integration**: Guidance on testing your subscription integration thoroughly.
*   **SaaS Integration**: Specific advice for integrating a Software as a Service (SaaS) business with Stripe Billing.

## Pricing and Product Management

*   **Recurring Pricing Models**: An overview of the pricing models available for subscriptions.
*   **Set up Flat Rate Pricing**: Configure subscriptions with a fixed price for service tiers.
*   **Set up Per-Seat Pricing**: Implement pricing where the cost is based on the number of users or seats.
*   **Set up Usage-Based Pricing**: Charge customers based on their consumption of your product or service.
*   **Set up Tiered Pricing**: Implement pricing where the unit cost varies based on quantity or usage.

## Data and Reporting

*   **Analytics**: Access and understand analytics related to your subscription revenue.
*   **Reporting**: Configure and utilize reports to gain insights into your billing data.
*   **Revenue Recognition**: Automate your accrual accounting process with Stripe Revenue Recognition.
*   **Data Overview**: Explore options for querying business data.
*   **Sigma**: Learn about Stripe Sigma for advanced data analysis.
*   **Data Pipeline**: Understand the next generation of data pipeline capabilities.