# 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 configurations, various pricing models, and integrating with diverse payment methods.

## Core Concepts and Setup

*   **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:** This guide walks you through the essential steps of creating a subscription integration, including product catalog setup, customer registration, payment collection, and managing subscription changes.
*   **Design a subscriptions integration:** Explore different pricing models (flat rate, per-seat, tiered, usage-based) and checkout strategies to best suit your business needs.
*   **Recurring pricing models:** Learn about the various pricing models available for subscriptions, including flat rate, per-seat, tiered, and usage-based pricing.
*   **Set up flat rate pricing:** Details on configuring subscriptions where customers pay a fixed price for a service tier.
*   **Set up per-seat pricing:** Guidance on implementing pricing based on the number of users or seats.
*   **Set up tiered pricing:** Information on setting up pricing where the unit cost varies based on quantity or usage.
*   **Set up usage-based pricing:** How to charge customers based on their actual consumption of your product or service.
*   **Embeddable pricing table for subscriptions:** Learn how to create and embed a visually appealing pricing table on your website that links directly to Stripe Checkout.
*   **Entitlements:** Understand how to map product features to Stripe products and manage customer access based on their subscription status.

## Subscription Management and Lifecycle

*   **Manage subscriptions:** General overview of managing subscriptions, including modifying, canceling, and pausing them.
*   **Modify subscriptions:** Learn how to change existing subscriptions, including prorated charges, pending updates, and managing billing impacts.
*   **Cancel subscriptions:** Instructions on how to cancel customer subscriptions, with details on immediate effect and future cancellations.
*   **Pause subscriptions:** How to temporarily suspend service delivery and invoice generation for subscriptions.
*   **Pause payment collection:** Learn how to temporarily stop collecting payments for subscriptions, often used for grace periods or offering services for free.
*   **Set the subscription billing renewal date:** Configure the billing cycle anchor to align future billing dates for subscriptions.
*   **Backdate subscriptions:** 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 or upgrades/downgrades.
*   **Pending updates:** Manage subscription updates that are applied only after successful payment of the new invoice.
*   **Bill customers in advance:** Utilize prebilling to charge customers for multiple service periods at once.

## Trials and Promotions

*   **Configure trial offers on subscriptions:** Set up both free and paid introductory periods for your subscriptions.
*   **Use free trial periods on subscriptions:** Legacy guide on offering free trials using the `trial_end` parameter.
*   **Manage compliance requirements for trials and promotions:** Understand and meet card network requirements for trial offers and promotional pricing.

## Pricing and Discounts

*   **Coupons and promotion codes:** Apply discounts to subscriptions and subscription items using coupons and promotion codes.
*   **Prorations:** Understand how prorated charges and credits are calculated when subscription details change.

## Payment Methods and 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:** Configure specific payment methods available for individual subscriptions.
*   **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:** Integrate US bank account payments for subscriptions.
*   **Set up a subscription with Amazon Pay:** Integrate Amazon Pay for subscription payments.
*   **Set up a subscription with Bacs Direct Debit in the UK:** Integrate UK Direct Debit payments for subscriptions.
*   **Set up a subscription with bank transfers:** Integrate bank transfer payments for subscriptions.
*   **Set up a subscription with BECS Direct Debit in Australia:** Integrate Australian Direct Debit payments for subscriptions.
*   **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:** Integrate iDEAL for initial payment and SEPA Direct Debit for recurring payments in the EU.
*   **Set up a subscription with Kakao Pay:** Integrate Kakao Pay for subscription payments in South Korea.
*   **Set up a subscription with Klarna:** Integrate Klarna for subscription payments.
*   **Set up a subscription with local South Korean cards:** Integrate local Korean card payments for subscriptions.
*   **Set up a subscription with Naver Pay:** Integrate Naver Pay for subscription payments in South Korea.
*   **Set up a subscription with Nigerian cards:** Integrate Naira card payments for subscriptions in Nigeria.
*   **Set up a subscription with PayPal:** Integrate PayPal for subscription payments.
*   **Accept subscription payments with PayTo:** Integrate PayTo for subscription payments in Australia.
*   **Set up a subscription with Pix:** Integrate Pix, a Brazilian instant payment system, for subscriptions.
*   **Set up a subscription with Revolut Pay:** Integrate Revolut Pay for subscription payments.
*   **Set up a subscription with SEPA Direct Debit:** Integrate SEPA Direct Debit for subscription payments in the EU.
*   **Set up a subscription with stablecoin payments:** Integrate stablecoin payments for subscriptions.
*   **Set up a subscription with third-party payment processing:** Use Stripe subscriptions and invoices with off-Stripe payment processors.
*   **Set up a subscription with TWINT:** Integrate TWINT for subscription payments in Switzerland.

## Advanced Features and Migration

*   **Mixed interval subscriptions:** Include multiple subscription items with different prices and billing periods on a single subscription.
*   **Migrate subscriptions to Stripe Billing:** Learn how to import existing subscriptions into Stripe Billing using the migration toolkit or Stripe APIs.
*   **Migrate subscriptions to Stripe Billing using toolkit:** Detailed guide on using the Billing migration toolkit for code-free migration.
*   **Migrate subscriptions to Stripe Billing using Stripe APIs:** Instructions on migrating subscriptions using custom scripts and Stripe APIs.
*   **Using webhooks with subscriptions:** Configure webhook endpoints to receive notifications for subscription events and manage asynchronous activities.
*   **Manage subscriptions on iOS:** Utilize the Billing SDK for iOS to manage subscriptions and entitlements within your iOS applications.
*   **Script language definition:** Understand the syntax and semantics of the scripting language used in Stripe Billing.
*   **Integrate a SaaS business on Stripe:** Guidance on building a Software as a Service business using Stripe Billing and other Stripe products.