Subscriptions Overview
How subscriptions are created and managed in GetPaidHQ.
A subscription is the recurring billing lifecycle created when an order with recurring prices is completed.
Creation
There is no direct subscription-create flow in the product model. Create an order with recurring items, then complete the order. Completing the order groups recurring lines into subscriptions by billing cadence.
What a subscription stores
- Customer and order relationship.
- Status.
- Payment method.
- Currency and billing cadence.
- Billing anchor and current period.
- Renewal, retry, and lifecycle timestamps.
- Metadata.
Lifecycle
A subscription can be paused, resumed, cancelled, or expire after its configured cycles. Payment failures can move it into recovery through dunning.
Status values
pendingtrialactivepast_duepausedcancelledexpired
Billing anchor
The billing anchor is the day of the month used for renewal. Changing it can require proration depending on your billing policy.
API details are in Subscriptions API and Orders & Checkout.