The subscription state describes the recurring billing arrangement. An invoice has its own state for one billing period. Store and evaluate these values separately.
Subscription states
Invoice states
How invoice outcomes affect the subscription
Subscription and invoice states aren't interchangeable. For example, an
unpaid invoice can make the subscription inactive, but unpaid isn't a subscription state.A skipped scheduled invoice moves from scheduled_invoices to skipped_invoices. It doesn't create a skipped invoice state.
See Failed payments and retries for recovery after a failed invoice payment.
Terminal and reversible states
cancelled is terminal. A cancelled subscription can't be resumed, and future recurring collection has already stopped.pausedcan be resumed through the resume subscription operation.inactivecan return topaidafter the unpaid invoice is paid successfully.
See Manage a fixed-price subscription for the state restrictions of update, skip, pause, resume, and cancel operations.