Subscription Lifecycle
Last reviewed: 16 November 2026
A subscription moves through stages from sign-up to its end. This page explains each stage in business terms, then what BillHive does. The step-by-step screens are in the Subscription Management manual.
Statuses at a glance
Which actions each status allows is listed in Actions by status. The portal shows only those buttons, and the API refuses the rest with a 400 error.
Every stage below is carried out by an order. The order is priced first (the order estimate), then placed, then turned into invoices and subscription changes. That is why every change has an estimate you can check before you confirm it.
Customer acquisition and plan selection
Business meaning. A prospect decides to buy. In B2C this happens on your website; in B2B, through a sales conversation.
How it works in BillHive.
- Self-serve: embed the Pricing Table on your site. The customer picks a plan and pays on Hosted Checkout. BillHive creates the customer account, order and subscription.
- Sales-led: an admin creates the customer, then the subscription from the customer page.
- API: your app creates the customer and places the order through the API.
Billing implication. Nothing is billed until an order is placed.
Subscription creation
Business meaning. The agreement starts: what the customer gets, at what price, from when.
User actions. Customers > a customer > Add Subscription: pick product, rate plan, price (currency and billing frequency), add-ons, offers, start date. Review the estimate and confirm. See Creating a Subscription.
System processing. BillHive prices the order, creates the subscription and its first term, raises the first invoice and, with Auto Collect, asks the gateway for payment.
| Effect | |
|---|---|
| Billing | The first term is billed from the start date. In-advance components bill now; in-arrears components bill at the end of the period. See Billing Timing. |
| Invoice | One invoice for the first term, including one-time fees and setup charges. |
| Payment | Auto Collect charges the saved method or mandate. Otherwise the invoice waits for payment within the payment terms. |
| Notification | Subscription Created email; Subscription Activated webhook. |
Start dates. A start date in the future creates a Future subscription. A start date in the past (backdating) is allowed up to the Backdating limit (90 days by default) in Subscription Settings.
Example. Acme Pvt Ltd signs up on 1 March for the Growth plan at ₹2,000/month plus GST. BillHive raises an invoice for ₹2,360 (₹2,000 + 18% GST) for 1–31 March and debits Acme’s UPI Autopay mandate.
Trial
Business meaning. The customer uses the product free for a while, so they can see its value before paying.
How it works in BillHive. The trial length is set on the rate plan price. A trial subscription starts in Trial. A few days before the end (the Trial reminder lead time, 5 by default) the customer gets a Trial Ending Soon email. When the trial ends, the subscription moves to Trial Pending Activation while the first payment is collected, then to Active. If payment is not collected, it becomes Trial Expired.
User actions during a trial.
| Action | What it does |
|---|---|
| Extend Trial | Pick a later end date. The activation moves with it. |
| Convert to Paid Now | Ends the trial today and bills the first full term today. |
| Cancel | Immediately only. Nothing is billed or credited. |
Plan and frequency changes are not available during a trial.
| Effect | |
|---|---|
| Billing | Nothing during the trial unless Require billing at signup is on. Then the customer must give a payment method up front. |
| Invoice | The first invoice is raised when the trial converts. |
| Payment | Collected at conversion. |
| Notification | Trial Started, Trial Ending Soon, Trial Activation emails. |
Example. A learner starts a 14-day trial of a ₹999/month course on 1 June. On 10 June they get the reminder. On 15 June BillHive bills ₹999 + GST and the subscription becomes Active.
Details: Trials, Trial Activation.
Activation
Business meaning. The customer becomes a paying subscriber with full access.
How it works in BillHive. A subscription becomes Active when its first payment is collected, or straight away when Activate before first payment is on (the default for future-dated Auto Collect subscriptions). Use Entitlements to give or take access based on the status.
Renewal
Business meaning. A term ends and the next one starts, so the customer keeps paying and keeps access.
How it works in BillHive.
- Renewal lead time days before the term ends (5 by default) BillHive raises the renewal invoice and payment request.
- On the renewal date the new term starts.
A renewal charges the price of the current term, not today’s list price. A Fixed price stops renewing after its term length; a Forever price renews until cancelled. With Auto Renew off the subscription becomes Non Renewing and you can renew it by hand.
| Effect | |
|---|---|
| Billing | Next term billed in advance; last term’s in-arrears usage billed on the same boundary invoice. |
| Invoice | One renewal invoice. |
| Payment | Auto-debit; failure starts dunning and the status becomes In Dunning. |
| Notification | Expiring Soon (if not renewing), Subscription Renewed. |
Example. A ₹12,000/year plan started 10 Jan 2026. On 5 Jan 2027 (5 days ahead) BillHive raises ₹14,160 including GST and debits the mandate; on 10 Jan 2027 the new term starts.
Moving the billing date. Edit Next Billing Date moves one subscription’s renewal to another day without charge or credit for the shifted days. See Changing the next billing date.
Details: Renewals.
Upgrade and downgrade
Business meaning. The customer moves to a bigger plan (upgrade, expansion revenue) or a smaller one (downgrade, contraction).
How it works in BillHive. Change Plan on an Active subscription. Choose when:
| Option | Effect |
|---|---|
| Immediately | Unused part of the old plan is credited, the new plan is charged from today (when Prorated Billing for Upgrade/Downgrade is on). |
| End of Term | Nothing changes until the renewal, which is billed on the new plan. |
| Specific Date | The change happens on that date, inside the current term. |
| Effect | |
|---|---|
| Billing | Prorated by your Proration Method. See Proration & Credits. |
| Invoice | An invoice for the net amount; a downgrade’s leftover credit becomes a credit memo that pays later invoices. |
| Payment | Auto Collect charges the difference. An upgrade on a mandate waits until the mandate covers the new amount. |
| Notification | Plan Upgraded / Plan Downgraded / Change Scheduled. |
Example (Actual days). Monthly ₹1,000 → ₹3,000 on day 16 of a 30-day term. Unused days = 15. Credit = 1,000 × 15/30 = ₹500. New charge = 3,000 × 15/30 = ₹1,500. Net due = ₹1,000 + GST.
Details: Plan & Frequency Changes.
Other modifications
| Change | When to use it | Page |
|---|---|---|
| Change Frequency | Monthly to yearly (or back). A different billing period starts a new term on the change date. | Plan & Frequency Changes |
| Add Addons | Sell an extra mid-term. Priced for the rest of the term. | Addon Management |
| Manage Addons | Remove an add-on or change a Flat Fee add-on’s quantity. | Addon Management |
| Pending charges | Add a one-off charge to the next invoice (API). | Pricing v2 API |
The newest action wins. A new plan or frequency change, pause or cancellation replaces any scheduled one. See The newest action wins.
Pause and resume
Business meaning. The customer stops for a while (a holiday, a seasonal business) without cancelling.
How it works in BillHive. Pause on an Active subscription, Immediately, at End of Term or on a Specific Date, with a resume date at least 2 days ahead. While paused, no invoices are raised. On resume, the term end moves out by the number of paused days, so the customer gets everything they paid for.
| Effect | |
|---|---|
| Billing | Stops while paused. Unbilled charges are invoiced or dropped per your settings. |
| Invoice | None while paused. |
| Payment | None while paused. |
| Notification | Subscription Paused, Subscription Resumed. |
Example. A 12-month term (1 Jan – 31 Dec) paused 1 March to 1 April (31 days) now ends 31 January next year.
A pause set for a future date can be removed before it starts with Remove Scheduled Pause. Details: Pause & Resume.
Extension
BillHive has three ways to give a customer more time:
| Situation | Use |
|---|---|
| Trial customer needs longer | Extend Trial |
| Paid customer should be billed later | Edit Next Billing Date (no charge for the days moved) |
| Customer was paused | Automatic: the term end moves out by the pause length |
There is no “add free days to a paid term” action. To give free time, move the next billing date or issue a credit memo.
Cancellation
Business meaning. The customer leaves. How you treat unused time, unpaid invoices and refunds shapes both revenue and goodwill.
How it works in BillHive. Cancel on the subscription:
| Status | Timing offered |
|---|---|
| Active, Paused | Immediately, End of Term, Specific Date |
| Trial, Future, Non Renewing, In Dunning | Immediately only |
Your cancellation policies decide:
- Unused period credit: none, prorated or full.
- Leftover credit: kept on the account or refunded.
- Unpaid invoices: left open, collected or written off.
- Contract terms: notice period and early termination fee.
| Effect | |
|---|---|
| Billing | A final bill may include in-arrears charges. Usage recorded in the current term is billed at renewal, so a mid-term cancel doesn’t invoice it. |
| Invoice | Credit memo for the unused period; early termination fee invoice if set. |
| Payment | Refund to the original method, or a Refund transaction for finance when paid offline. |
| Notification | Cancellation Scheduled (deferred) or Subscription Cancelled. |
Example. ₹2,656/month, term 23 Oct – 22 Nov (31 days), cancelled for 8 Nov with prorated credits: 15 unused days → credit ₹1,285.16.
Details: Cancellation.
Reactivation
Business meaning. A customer who left comes back.
How it works in BillHive. Reactivate on a Cancelled or Expired subscription starts a new term today on the same subscription, at the plan’s current list price, with the plan’s mandatory add-ons only. It stays Cancelled/Expired until the first payment is collected. Customers can reactivate from the self-serve portal only when that option is turned on (it is off by default).
Expiration
Business meaning. The agreement runs out without renewing.
How it works in BillHive. A Non Renewing subscription becomes Expired at the end of its last term. The customer gets an Expiring Soon email beforehand and a Subscription Expired email after. Unlike a cancellation, nothing is credited, because the term was used in full. Details: Expiration.
Related
- Subscription workflows: diagrams of each process.
- Subscription troubleshooting.