Billing Fundamentals
Last reviewed: 16 November 2026
This page explains how recurring billing works: when invoices are raised, what goes on them, and how money flows back through credits and refunds.
Billing frequency, cycle and term
| Term | Meaning | Example |
|---|---|---|
| Billing frequency | How often the customer is billed. BillHive supports periods of Day, Week, Month and Year, with a count. | Every 1 Month, every 3 Months, every 1 Year |
| Billing cycle | One billing period | 1–31 March |
| Term | The span between renewals. It can cover several cycles. | A 12-month term billed monthly |
| Term length | On a Fixed price, how many cycles are billed before renewals stop | 12 |
Billing frequencies are set up in Settings > Billing Frequencies and grouped into billing strategies. See Billing Frequency, Billing Cycle and Term Length.
Billing anchor
The billing anchor is the day of the period billing is tied to.
- Anniversary billing (what BillHive does): each subscription is billed on the anniversary of its start date. A subscription started on 18 March bills on the 18th of each month.
- Calendar billing (not available): every subscription billed on the same day, such as the 1st, with the first period prorated. BillHive doesn’t offer this.
To move one subscription’s billing day, use Edit Next Billing Date. The current term ends the day before the new date, and nothing is charged or credited for the days moved. See Changing the next billing date.
Advance and arrears billing
| Timing | Billed | Typical use |
|---|---|---|
| In advance | At the start of the period it covers | Subscription fees, seats |
| In arrears | At the end of the period it covers | Usage, overage |
A price with any in-arrears line is billed at the period boundary on one invoice that carries next period’s in-advance lines and last period’s in-arrears lines. See Boundary Invoicing.
Example. ₹15/month plan in advance, plus emails at ₹0.004 above 15,000 included. In March the customer sent 18,000 emails. The 1 April invoice carries ₹15 for April and 3,000 × ₹0.004 = ₹12 for March.
Prorated billing
When something changes mid-period, only the affected days are billed or credited. BillHive prorates:
- plan and frequency changes (when Prorated Billing for Upgrade/Downgrade is on),
- add-ons added or removed mid-term,
- cancellation credits (per the Unused Period Credit Policy).
The Proration Method (Actual days, 30/360 or Whole months) decides how days are counted. See Proration & Credits.
Unbilled and pending charges
- Pending charges are one-off or per-event fees waiting for the next invoice. You add them through the API and can list or cancel them before they are billed. See Charge an event fee.
- Unbilled usage is usage recorded but not yet invoiced. It is billed at the period boundary.
- When a subscription is paused or cancelled, your settings decide whether unbilled charges are invoiced straight away or dropped.
Each charge lands on exactly one invoice, so retries never bill twice.
Invoice generation
Invoices are raised automatically when:
| Event | Invoice |
|---|---|
| A subscription starts | First term |
| A renewal is due | Renewal lead time days before the renewal date (5 by default), or at the boundary for in-arrears prices |
| A plan, frequency or add-on change is billed | The net amount |
| A cancellation has an early termination fee or a final bill | The fee or final in-arrears lines |
You can also create a custom invoice by hand from a customer’s page. See Creating Custom Invoices.
Invoice statuses
| Status | Meaning |
|---|---|
| Draft | Being prepared; not sent |
| Posted | Final and sent; amount due |
| Partial | Partly paid |
| Paid | Fully paid |
| Overdue | Past its due date and not paid |
| Written Off | Declared uncollectable |
| Cancelled | Voided |
The due date is the invoice date plus the account’s net term days. See Net Term Days.
Credit notes (credit memos)
A credit memo records money owed to the customer. It can be applied to unpaid invoices or refunded. BillHive raises one automatically for:
| Source | When |
|---|---|
| Plan Downgrade | A plan change leaves the customer in credit |
| Subscription Cancellation | Unused-period credit on cancel |
You can raise others by hand, for example for a billing error, goodwill, a partial refund, a tax adjustment or an overpayment. A debit memo does the opposite: it adds an amount the customer owes. See Credit and Debit Memos.
Example. A customer on ₹3,000/month downgrades to ₹1,000/month halfway through a 30-day term. The credit for the old plan (₹1,500) exceeds the charge for the new one (₹500), so a ₹1,000 credit memo is raised and pays the next invoice.
Refunds
- On cancellation, credits first pay the customer’s unpaid invoices. The Refundable Credit Action then keeps the rest as credit or refunds it.
- Refunds go back to the original gateway payment. If the customer paid offline, BillHive creates a Refund transaction for your finance team to pay out. See Offline Refunds.
Tax
BillHive calculates India GST when Settings > Taxation is set to Calculated by BillHive. GST is worked out per invoice line and rounded to paise; the invoice total is the sum of the lines. Within a state, GST is split into CGST and SGST; between states, IGST applies. Each price says whether it includes tax and which tax profile (rate and HSN/SAC) it uses.
Example. ₹2,000 plan, 18% GST, customer in the same state: CGST ₹180 + SGST ₹180 = ₹2,360.
US sales tax and EU VAT are not available yet. BillHive doesn’t file tax returns. See Taxation Settings and GST Invoicing.
Outstanding balances
A customer’s outstanding balance is the total of their unpaid and partly paid invoices, less unapplied credits. The customer page shows invoice, credit and debit balances. See Balance Types.
Payment collection
| Mode | How it works |
|---|---|
| Auto Collect | BillHive charges a saved card or mandate (UPI Autopay, eNACH) on the due date |
| Manual | The customer pays an invoice link, or you record an offline payment (cash, cheque, bank transfer) |
See Payments & Dunning.