## Stripe Subscriptions Documentation

This documentation suite covers the comprehensive management of subscriptions within Stripe, from initial integration to advanced configuration and payment method support. It's designed for developers and businesses looking to implement and manage recurring billing for their products and services.

### Core Concepts and Setup

*   **Subscriptions Overview (`/billing/subscriptions/overview`):** Understand the fundamental concepts of Stripe Subscriptions, including recurring payments, customer information management, and the subscription lifecycle.
*   **Build a Subscriptions Integration (`/billing/subscriptions/build-subscriptions`):** A foundational guide to creating a subscription integration, covering product catalog setup, customer registration, payment collection, and ongoing management.
*   **Design a Subscriptions Integration (`/billing/subscriptions/design-an-integration`):** Explore various strategies for charging customers, checkout flows, and payment timing to design an effective subscription integration.
*   **Recurring Pricing Models (`/products-prices/pricing-models`):** Learn about different pricing models like flat-rate, per-seat, tiered, and usage-based pricing for your subscription products.
    *   **Set up Flat Rate Pricing (`/subscriptions/pricing-models/flat-rate-pricing`):** Implement a straightforward pricing model where customers pay a fixed rate for a service tier.
    *   **Set up Per-Seat Pricing (`/subscriptions/pricing-models/per-seat-pricing`):** Configure pricing based on the number of users or licenses required.
*   **Embeddable Pricing Table (`/payments/checkout/pricing-table`):** Create and embed a customizable pricing table on your website that links directly to Stripe Checkout.
*   **Entitlements (`/billing/entitlements`):** Manage customer access to product features based on their subscription status, allowing for dynamic provisioning and de-provisioning of services.

### Subscription Management and Lifecycle

*   **How Subscriptions Work (`/billing/subscriptions/overview`):** Delves deeper into the mechanics of subscription lifecycles, from creation to active status and beyond.
*   **Configure Subscription Events (`/billing/subscriptions/configure-subscription-events`):** Understand how to manage subscription events and set up webhook endpoints for real-time notifications.
*   **Manage Subscriptions (`/billing/subscriptions/build-subscriptions`):** General guidance on managing the lifecycle of subscriptions.
*   **Set the Subscription Billing Renewal Date (`/billing/subscriptions/billing-cycle`):** Control the billing cycle anchor to align renewal dates with your business needs.
*   **Modify Subscriptions (`/billing/subscriptions/change`):** Learn how to update existing subscriptions, including changing prices, quantities, and applying prorated charges.
    *   **Change the Price of Existing Subscriptions (`/billing/subscriptions/change-price`):** Specific instructions on upgrading or downgrading subscriptions by altering their prices.
*   **Manage Prorations (`/billing/subscriptions/prorations`):** Understand how Stripe calculates prorated charges and credits when subscription details are modified.
*   **Pending Updates (`/billing/subscriptions/pending-updates`):** Handle subscription updates that require payment confirmation to prevent issues with failed payments.
*   **Cancel Subscriptions (`/billing/subscriptions/cancel`):** Procedures for canceling subscriptions, including immediate cancellations and automatic cancellations due to payment failures.
*   **Pause Subscriptions (`/billing/subscriptions/pause`):** Temporarily suspend subscriptions, halting both service delivery and invoice generation.
*   **Pause Payment Collection (`/billing/subscriptions/pause-payment`):** Temporarily stop collecting payments for subscriptions while maintaining service.
*   **Bill Customers in Advance (`/billing/subscriptions/prebilling`):** Set up prebilling to charge customers for multiple future service periods at once.
*   **Subscription Schedules (`/billing/subscriptions/subscription-schedules`):** Automate changes to subscriptions over time, such as backdating or future upgrades.
*   **Backdate Subscriptions (`/billing/subscriptions/backdating`):** Bill customers for past periods or migrate existing subscriptions with a specified start date.
*   **Mixed Interval Subscriptions (`/billing/subscriptions/mixed-interval`):** Include multiple subscription items with different billing periods on a single subscription for consolidated invoicing.

### Trials and Discounts

*   **Configure Trial Offers (`/billing/subscriptions/trials`):** Set up free or paid trial periods for subscription items.
    *   **Use Free Trial Periods (`/billing/subscriptions/trials/free-trials`):** Implement free trial periods using legacy parameters.
*   **Manage Compliance Requirements for Trials and Promotions (`/billing/subscriptions/trials/manage-trial-compliance`):** Ensure compliance with card network requirements for trial offers and promotions.
*   **Coupons and Promotion Codes (`/billing/subscriptions/coupons`):** Apply discounts to subscriptions and subscription items using coupons and promotion codes.

### Payment Methods and Integrations

*   **Collect a Payment Method with No Initial Payment (`/billing/subscriptions/deferred-payment`):** Authorize and store payment methods for subscriptions that don't require an immediate charge.
*   **Set Payment Methods Per-Subscription (`/billing/subscriptions/payment-methods-setting`):** Configure specific payment methods available for individual subscriptions.
*   **Integrate with Third-Party Payment Processors (`/billing/subscriptions/third-party-payment-processing`):** Use Stripe subscriptions and invoices with external payment processors.
*   **Set up a Subscription with ACH Direct Debit (`/billing/subscriptions/ach-debit`):** Integrate US bank account payments for subscriptions.
*   **Set up a Subscription with Amazon Pay (`/billing/subscriptions/amazon-pay`):** Enable Amazon Pay for subscription payments.
*   **Set up a Subscription with Bacs Direct Debit (`/billing/subscriptions/bacs-debit`):** Integrate UK Direct Debit for subscription payments.
*   **Set up a Subscription with Bank Transfers (`/billing/subscriptions/bank-transfer`):** Configure subscriptions to accept payments via bank transfers.
*   **Use Boleto with Subscriptions (`/payments/boleto/set-up-subscription`):** Integrate Boleto, a Brazilian voucher payment method, for subscriptions.
*   **Set up a Subscription with Cash App Pay (`/billing/subscriptions/cash-app-pay`):** Enable Cash App Pay for subscription payments.
*   **Set up a Subscription with iDEAL and SEPA Direct Debit (`/billing/subscriptions/ideal`):** Combine iDEAL for initial payment and SEPA Direct Debit for recurring payments.
*   **Set up a Subscription with Kakao Pay (`/billing/subscriptions/kakao-pay`):** Integrate Kakao Pay for subscription payments in South Korea.
*   **Set up a Subscription with Klarna (`/billing/subscriptions/klarna`):** Enable Klarna for subscription payments.
*   **Set up a Subscription with Local South Korean Cards (`/billing/subscriptions/kr-card`):** Accept payments via local South Korean card networks.
*   **Set up a Subscription with Naver Pay (`/billing/subscriptions/naver-pay`):** Integrate Naver Pay for subscription payments in South Korea.
*   **Set up a Subscription with Nigerian Cards (`/billing/subscriptions/ng-card`):** Accept payments via Nigerian card networks.
*   **Accept Subscription Payments with PayTo (`/billing/subscriptions/payto`):** Integrate PayTo for subscription payments in Australia.
*   **Set up a Subscription with PayPal (`/billing/subscriptions/paypal`):** Enable PayPal for subscription payments.
*   **Set up a Subscription with Pix (`/billing/subscriptions/pix`):** Integrate Pix, a Brazilian instant payment system, for subscriptions.
*   **Set up a Subscription with Pre-authorized Debit in Canada (`/billing/subscriptions/au-becs-debit`):** Configure Canadian pre-authorized debit for subscriptions.
*   **Set up a Subscription with Revolut Pay (`/billing/subscriptions/revolut-pay`):** Enable Revolut Pay for subscription payments.
*   **Set up a Subscription with SEPA Direct Debit (`/billing/subscriptions/sepa-debit`):** Integrate SEPA Direct Debit for subscription payments in the EU.
*   **Set up a Subscription with Stablecoin Payments (`/billing/subscriptions/stablecoins`):** Accept recurring payments in stablecoins.
*   **Set up a Subscription with TWINT (`/billing/subscriptions/twint`):** Enable TWINT for subscription payments in Switzerland.
*   **Set up a Subscription with BECS Direct Debit in Australia (`/billing/subscriptions/au-becs-debit`):** Integrate Australian BECS Direct Debit for subscriptions.

### Migration and Advanced Topics

*   **Migrate Subscriptions to Stripe Billing (`/billing/subscriptions/migrate-subscriptions`):** Comprehensive guide to migrating existing subscriptions to Stripe Billing.
    *   **Migrate Subscriptions using a Toolkit (`/billing/subscriptions/import-subscriptions-toolkit`):** Utilize the Stripe Dashboard toolkit for code-free subscription migration.
    *   **Migrate Subscriptions using Stripe APIs (`/billing/subscriptions/import-subscriptions`):** Import subscriptions programmatically using Stripe APIs.
*   **Compare Classic and Flexible Billing Mode (`/billing/subscriptions/billing-mode/compare`):** Understand the differences between classic and flexible billing modes to choose the best option for your integration.
*   **Enable Billing Mode (`/billing/subscriptions/billing-mode`):** Activate flexible billing mode for enhanced subscription management features.
*   **Manage Subscriptions on iOS (`/billing/subscriptions/manage-ios`):** Integrate Stripe's Billing SDK for iOS to manage subscriptions and entitlements within your iOS app.
*   **Using Webhooks with Subscriptions (`/billing/subscriptions/webhooks`):** Implement webhooks to receive real-time notifications about subscription activity.
*   **Script Language Definition (`/billing/scripts/script-language`):** Learn about the syntax and semantics of Stripe's scripting language, used for advanced billing logic.
*   **Integrate a SaaS Business on Stripe (`/saas`):** A guide tailored for SaaS businesses, covering subscriptions and other Stripe products.

This documentation set provides a robust resource for implementing and managing subscription services with Stripe.