Knowledge BaseBilling Fundamentals

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

TermMeaningExample
Billing frequencyHow 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 cycleOne billing period1–31 March
TermThe span between renewals. It can cover several cycles.A 12-month term billed monthly
Term lengthOn a Fixed price, how many cycles are billed before renewals stop12

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

TimingBilledTypical use
In advanceAt the start of the period it coversSubscription fees, seats
In arrearsAt the end of the period it coversUsage, 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:

EventInvoice
A subscription startsFirst term
A renewal is dueRenewal 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 billedThe net amount
A cancellation has an early termination fee or a final billThe 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

StatusMeaning
DraftBeing prepared; not sent
PostedFinal and sent; amount due
PartialPartly paid
PaidFully paid
OverduePast its due date and not paid
Written OffDeclared uncollectable
CancelledVoided

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:

SourceWhen
Plan DowngradeA plan change leaves the customer in credit
Subscription CancellationUnused-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

ModeHow it works
Auto CollectBillHive charges a saved card or mandate (UPI Autopay, eNACH) on the due date
ManualThe customer pays an invoice link, or you record an offline payment (cash, cheque, bank transfer)

See Payments & Dunning.