Billing Issues
Last reviewed: 16 November 2026
The proration amount looks wrong
Check, in order:
- Proration Method: Actual days, 30/360 or Whole months. Whole months credits ₹0 for a part month.
- Prorated Billing for Upgrade/Downgrade: when off, a same-period plan change charges the full new price with no credit.
- The day count includes the change day. On day 16 of a 30-day term, 15 days are left.
- A change to a different billing period (monthly → yearly) starts a new term; the unused old term is credited against the full new price.
Fix. Compare with the worked examples in Proration & Credits. Correct a real error with a credit or debit memo.
No invoice was raised for the renewal
Causes.
- The subscription is Non Renewing (Auto Renew off, or a Fixed price used up).
- It’s not yet Renewal lead time days (5 by default) before the renewal date.
- The price has in-arrears lines, so the invoice is raised at the boundary, not early.
- The subscription is paused.
Check. Status, next billing date and auto-renew on the subscription page; the price’s billing timing.
Usage is missing from the invoice
Causes.
- Events arrived after the period closed and after the Late usage window.
- The event’s
eventTypeor properties don’t match the component’s meter or filters. - Duplicate
eventIds were rejected. - The subscription was cancelled mid-term: usage of the current term is billed at renewal, so a mid-term cancel doesn’t invoice it.
Check. Usage in the portal for the subscription’s events and their status. See Testing Usage Billing.
Prevent. Send events promptly; set a Late usage window if your data arrives late.
The package (pack) charge is higher than expected
Cause. Rounding UP charges a full pack for a part pack, on the period total. 2,500 calls in packs of 1,000 = 3 packs.
Fix. Use Charge the fraction (proportional) or Ignore the part pack if that’s your policy.
GST is missing or wrong
Check.
- Settings > Taxation is set to Calculated by BillHive (new businesses start on Handled by you).
- Your GSTIN is entered; without it you see Add your GSTIN first.
- The price’s tax profile (rate and HSN/SAC) and whether the price includes tax.
- The customer’s state: same state → CGST + SGST; different state → IGST.
- Pass-through lines follow the plan’s Charge GST on pass-through lines switch.
- Lines paid from prepaid credits carry no GST; GST was charged on the top-up.
See Taxation Settings.
The invoice total differs from the estimate by paise
Cause. Each line and its GST are rounded to paise, and the total is the sum of rounded lines.
Fix. None needed; this is how GST invoices must be rounded.
A discount didn’t apply
Find the reason in the order estimate; BillHive names it, e.g. This offer has reached its maximum redemption limit. The full list is in Offers & Coupons.
A discount stopped on renewal
Causes. The offer is Single Use, or Limited Time and its duration has passed, or the offer was deactivated, or the plan changed to one the offer doesn’t apply to. See Discounts on renewal.
A downgrade credit didn’t come back as money
Cause. A downgrade credit is a credit memo that pays later invoices on the account. It isn’t refunded automatically.
Fix. Refund it by hand if the customer asks. See Credit and Debit Memos.
The same charge appears twice
BillHive puts each charge on exactly one invoice. If you see two, check whether two orders were placed (for example an API retry after a timeout). Cancel the extra invoice or issue a credit memo, and look up orders before retrying in your integration.