Frequently Asked Questions

Last reviewed: 16 November 2026

Subscription creation

Can a subscription start in the future? Yes. It is Future until the start date, and can only be cancelled immediately in the meantime.

Can I start a subscription in the past? Yes, up to the Backdating limit (90 days by default) in Subscription Settings.

Can one customer have several subscriptions? Yes, on the same or different products.

Can I charge a negotiated price? Yes, with Price Override on, when an admin places the order in the portal. API keys can’t set custom prices.

Billing and proration

Why was my customer billed for only part of the month? A mid-term change or add-on is prorated for the days left in the term. See Proration & Credits.

Can I bill everyone on the 1st of the month? No; billing is anniversary-based. You can move individual subscriptions with Edit Next Billing Date.

When is the renewal invoice sent? 5 days before the renewal date by default (Renewal lead time). Prices with usage or in-arrears lines are invoiced on the renewal date instead.

Does a list price change affect current customers? No. Renewals use the subscription’s own term price. Move customers with Change Plan if you want them on the new price.

Is usage billed when a customer cancels mid-term? Not today; current-term usage is billed at renewal. Cancel at end of term to bill it.

Invoices

Can I create an invoice by hand? Yes: a custom invoice from the customer page.

Can I correct a posted invoice? Use an invoice adjustment, a credit or debit memo, or a reversal.

Does BillHive file my GST returns? No. It calculates GST and shows it on documents; filing stays with you.

Payments and dunning

Which gateways can I use? Cashfree with self-serve onboarding; Razorpay onboarding is coming next.

What happens when a payment fails? Dunning retries and emails the customer over about three weeks, then cancels and writes off the invoice if nothing is recovered. See Payments & Dunning.

Can I stop dunning for one customer? Pausing or skipping dunning is planned, not available yet. You can cancel or record a payment.

Can customers pay by bank transfer? Yes. Turn off Auto Collect, set net term days, and record the payment when it arrives.

Trials

Can I give a customer more trial days? Yes, Extend Trial, while the subscription is in Trial.

Can a customer start paying before the trial ends? Yes, Convert to Paid Now. They pay the full first term; unused trial days aren’t credited. In the self-serve portal this needs the convert option turned on.

Can a trial customer change plan? Not during the trial. Convert first, then change plan.

Renewals

How do I stop a subscription from renewing? Turn off Auto Renew, or cancel at End of Term.

Can a customer come back after cancelling? Yes, Reactivate a Cancelled or Expired subscription. It restarts today at the current list price.

Cancellation and refunds

Does the customer get money back on cancel? Depends on your Unused Period Credit Policy and Refundable Credit Action. Credits pay unpaid invoices first; the rest is kept as credit or refunded.

Can I undo a scheduled cancellation? Yes, remove it from the subscription page before the date.

Pricing configuration

Can one plan have a fixed fee and usage? Yes, add several components to one price.

Can I offer a discount for the first 3 months only? Yes, an offer with Limited Time 3 months.

Can I sell prepaid credit packs? Yes. See Prepaid Credits.

Usage

What if I send the same usage event twice? The second is rejected because the eventId is the same.

Can I send usage late? Within the Late usage window after the term ends (0 days by default).

Reports

Why doesn’t MRR match this month’s invoices? MRR counts recurring revenue normalised to a month; invoices include one-time fees, usage, taxes and yearly bills.

Do the reports give accounting revenue? No. BillHive shows subscription metrics, not recognised revenue.

Integration

How do I authenticate API calls? Send x-api-key: <key>. See Developer Settings.

Are webhooks signed and retried? Not yet. See Webhook.