Subscriptions manage automated recurring billing for customers, tracking billing cycles, payment status, and subscription lifecycle from trial to completion. Key Benefits# Automated Recurring Revenue - Generate invoices and collect payments automatically on scheduled billing cycles
Flexible Billing Management - Support daily, weekly, monthly, and yearly billing periods with usage tracking
Complete Lifecycle Control - Manage trial periods, grace periods, pauses, and subscription termination
Subscription Status# Active - Subscription is running normally with successful billing
Paused - Subscription temporarily halted, can be resumed
Suspended - Subscription stopped due to payment failure or grace period expiry
Ended - Subscription completed its billing cycles
Cancelled - Subscription manually terminated
Billing Cycle Properties# Duration & Unit - Billing frequency (1 day, 1 week, 1 month, etc.)
Billing Dates - Current period start/end, last billing, next billing dates
Total Cycles - Maximum number of billing periods before automatic termination/renewal
Remaining Cycles - Number of billing periods left in subscription term
Subscription Components# Invoice Management# Each billing cycle generates an invoice automatically: Historical Invoices - Complete payment history with serials and status
Next Invoice - Upcoming billing details and payment URL for unpaid invoices
Payment Tracking - Links to successful payments and failed attempts
Usage Tracking# For usage-based subscriptions: Usage Counter - Current period usage amount
Usage Limit - Maximum allowed usage per billing cycle
Auto Increment - Automatic daily usage counting for specific units
Usage Units - Measurement types (credits, sessions, days)
Trial & Grace Periods# Trial Period - Free access before first billing cycleGrace Period - Payment retry window before suspensionAuto Renewal - Automatic subscription continuation settingsCustomer Usage# Common Use Cases: Display subscription status and billing history, show next billing dates and amounts, provide subscription management interfaces, track usage limits and consumption.List Customer Subscriptions# Retrieve all active and historical subscriptions for authenticated customers with status and billing information. List Subscriptions . Get Subscription Details# Access detailed subscription information including billing history, usage tracking, and next invoice details. Subscription Details . Cancel Auto Renewal# Auto Renewal Cancellation
Cancelling auto renewal only disables future renewals. The subscription remains active until the current period ends, then moves to "ended" status.
Merchant Integration# For detailed subscription management and analytics, see Subscriptions . 