Product Type: Subscription
A Subscription product bills the customer recurringly on a defined cycle — weekly, monthly, yearly, and so on — rather than as a one-off purchase.
What defines a Subscription product?
A Subscription product bills the customer recurringly on a defined cycle — weekly, monthly, yearly, and so on — rather than as a one-off purchase.
How is the billing cycle and interval configured?
SubscriptionDetail defines the billing cycle (Day, Week, Month, or Year) and the interval (a multiplier — e.g.
What is the difference between Manual and Stored (card-on-file) billing modes?
There are two billing modes.
How does the daily billing sweep invoice due cycles?
A daily background job (a Hangfire recurring sweep) looks for subscription cycles that are due and processes them: it generates the cycle's invoice/charge, and in Stored mode attempts payment…
How does dunning work when a renewal payment fails?
When a Stored-mode renewal charge fails, the subscription enters dunning: the system retries payment on a schedule (tracking dunning attempts and the last attempt time) and moves the…
What are the subscription statuses (Active, PastDue, Suspended, Cancelled)?
A subscription moves through a clear set of statuses.
How does a customer cancel, and what happens to access until period end?
A customer can request cancellation of a subscription from their account.
How do upgrades/downgrades and proration work mid-cycle?
A subscription can be upgraded or downgraded mid-cycle, with proration applied so the customer is charged or credited fairly for the unused portion of the current period, and the next…
How is a trial period handled?
SubscriptionDetail can specify a trial length (trial days).
How does a customer attach a saved card for auto-renewal?
To enable auto-renewal, a customer attaches a saved card to the subscription.
How do subscription refunds and proration work?
Subscription refunds are handled per policy, commonly by prorating or refunding the current cycle — for example refunding the unused portion of a period on cancellation, or the whole…