21 min read

Plans & Billing

How to view your current plan, change plans, track usage against your limits, and understand what happens if a renewal payment fails.

Your BillionBiz plan controls two distinct things: features (capabilities that are on or off) and limits (caps on how many products, users, coupons, or orders you can have). Everything about your subscription — reviewing it, changing it, and paying for it — happens on the Billing screen.

Go to Settings → Billing & Plan (there's no sidebar item literally named "Billing" — it's a card inside the Settings hub, at /settings/billing).

Key points

  • Nothing you already have is ever deleted when you hit a plan limit — BillionBiz just stops you from adding more until you upgrade.
  • Switching plans shows you the exact amount due today before you confirm anything.
  • Downgrading never deletes data — items over the new plan's limit are locked, not removed, and come back the moment you upgrade again.
  • A missed renewal payment moves your subscription to a Grace Period, not an instant shutdown.

The Billing screen

On the classic admin skin, the Billing screen is divided into up to three tabs: Plan & Billing, Usage, and — for store-level admins (Owner/StoreAdmin, not Vendor) — Add-ons.

v2 skin: a different tab layout

On the newer v2 skin, the same screen is restructured into up to six tabs: overview, plan, invoices, payment, usage, and (for store-level admins) addons. The underlying data and actions are the same as the classic skin's tabs — they're just grouped differently. This page describes the classic layout first and calls out v2's equivalent tab wherever it differs.

Plan & Billing tab

The top card shows your current plan at a glance: plan name, status (Active, Grace Period, Past Due, Suspended, and so on), monthly price, the date your subscription started, and the date it next renews. Next to it, a View Plans button opens the plan chooser.

Below that are two sub-tabs:

Sub-tabWhat it shows
PaymentsEvery transaction — date, amount, and status (Success, Pending, Failed, Refunded).
InvoicesEvery invoice issued for your subscription, each with a download button for your accounting records.

Successful automatic renewals appear here too. A successful store-plan or separately billed monthly add-on renewal creates a payment and a paid invoice for the renewed period.

Find a renewal charge and download its invoice

Open Billing

Go to Settings → Billing & Plan. On the classic skin, stay on Plan & Billing and find Billing History. On the v2 skin, open overview and find billing history.

Check the payment

Open Payments on the classic skin or payments under v2 billing history. Match the renewal by date and amount. On the classic skin the Type column shows RENEWAL for a plan renewal and ADDON for a monthly add-on renewal. On v2, plan renewals show renewal while monthly add-on renewals show ADDON.

Open the invoice list

Open Invoices on the classic skin. On v2, use tax invoices under billing history, or open the top-level invoices tab. Match the paid invoice by its issued date, period, and total, then use Download PDF (shown as download PDF on the v2 invoices tab).

On the v2 overview, the paid invoice also contributes to billing trend → monthly spend.

v2's invoices tab adds filtering and pagination

On the v2 skin's invoices tab, invoices are shown 10 at a time with Prev/Next paging once you have more than 10, plus a status filter dropdown (all, paid, pending, refunded) above the table. The classic skin's Invoices sub-tab lists every invoice on one page without a status filter.

The Saved Payment Methods section lists every card or UPI address on file. You can set one as the default for automatic renewals, or remove one you no longer use — both actions work the same way on the classic and the v2 skin.

Adding a new payment method is coming soon

The Add Payment Method button is shown disabled with a tooltip on both skins — there's currently no in-app form for adding or replacing a saved method. Plan and add-on payments open Razorpay's hosted Checkout, and BillionBiz does not show its own card-saving control there.

Plan Usage tab

This tab shows how close you are to each of your plan's tracked limits — Products, Users, Coupons, Monthly Orders, Emails, and others — as a labelled progress bar.

Usage levelWhat happens
Below 80%Normal progress bar, no warning.
80% or aboveA yellow warning appears so you have time to plan ahead.
100%A red alert reading "Plan limit reached. Upgrade to add more." appears with a direct Upgrade button.
Unlimited on your planShown as "X / Unlimited" — no cap.

If you run a marketplace with multiple vendors, each resource row can be expanded to show a per-vendor breakdown of how much of the allowance each seller is consuming.

The Products row counts SKUs, not product rows

The Products number on this tab is your active SKU count — the product's own SKU plus every active variant's SKU, counted once each. A product with many variants uses up far more of this allowance than one row. Full detail (including what "over the limit" does to a product) is in Adding & Editing Products: Your plan's product limit.

Customers is the one exception — it never blocks

Every resource on this tab shows the same red "at limit" banner at 100%, but Customers behaves differently underneath: creating a new customer (from the admin panel or a shopper registering on your storefront) or reactivating a previously-deactivated one is never refused, even past 100%. The count and the red banner are still accurate — you just won't hit a hard stop, because blocking storefront registration would take your store offline for new shoppers instead of just upselling you. See The Customers Screen: If your plan has a customer limit for what "soft" means in practice.

v2's usage tab now matches the classic skin

The v2 skin's usage tab shows every tracked limit with the same per-vendor breakdown described above — it's no longer limited to a four-feature summary. Numbers should match between skins.

What happens at the monthly order cap

Unlike Customers above, Monthly Orders is a hard limit — once a store reaches its plan's order count for the calendar month (UTC), every new-order action is refused until the counter resets or you upgrade. The count is a live count of every order row created this calendar month, regardless of status, so cancelled or refunded orders still count toward it.

Every order-creation path is blocked, not just storefront checkout

Reaching the cap refuses all of the following the same way:

  • A customer completing checkout on your storefront.
  • An admin creating a manual order.
  • Converting a quote/draft document into an order from Documents.
  • A customer completing checkout through your WhatsApp ordering bot.

One exception: an order created to finish recording a payment your gateway already captured (a recovery pass that runs when a payment succeeded but no order was ever created for it) is never blocked by this cap — refusing it would mean taking a customer's money without ever producing an order for it. That recovered order still counts toward the same monthly total afterwards.

What the customer sees: checkout fails with an error toast reading the backend's raw message — literally You have reached the limit for "orders_monthly" in your current plan — rather than polished, store-branded copy. There's no dedicated "sorry, we're sold out for the month" screen yet; the toast is the only signal a shopper gets. On the WhatsApp ordering bot the copy is friendlier: "This store has reached its order limit for this month. Please contact the store directly to place your order, or try again next month."

What the admin sees: the same raw backend message shown as a toast when a manual order or document-to-order conversion is blocked, plus the Plan Usage tab's normal 80%/100% progress-bar treatment described above. Separately, BillionBiz emails the store's admin once when usage crosses 80% and once when it crosses 95% of the order cap (a single email per threshold per 24 hours, not one email per order) — this is independent of the Plan Usage tab and fires even if nobody opens the Billing screen.

If the plan-limits service is unreachable, checkout fails closed

If BillionBiz's plan-and-billing service can't be reached to check the store's current usage, checkout (and every other order-creation path above) is refused rather than allowed through — the customer sees a temporary "please retry" error instead of the order silently skipping the cap check. This is deliberate: treating an unreachable limit check as "no limit" would let a store's order count run past its plan during an outage.

When the counter resets: at the start of each calendar month, UTC — there's no in-app control to reset it early or extend it mid-cycle short of upgrading to a plan with a higher (or unlimited) order allowance.

Troubleshooting: “Why did checkout suddenly stop working?”

If customers report checkout failing, or your own admin/manual order creation starts failing, check the Plan Usage tab's Monthly Orders row first. If it's at or past 100%, that's the cause — upgrade the plan, or wait for the 1st of next month (UTC) for the counter to reset. This is one of the few limits that blocks a customer-facing flow rather than just an admin action, so it's worth checking before assuming a bug.

Add-ons tab

If you're an Owner or Store Admin (this tab isn't shown to Vendor accounts), a third tab — Add-ons — lets you buy and manage available BillionBiz add-ons directly from the Billing screen, whether or not you already have hosting. It shows the same cards as the standalone Add-ons page:

  • Each add-on (for example, the hosting app add-on — 1 hosted site, 5 GB storage, 50 GB bandwidth/month, 500 form submissions/month, GA4/pixel injection, per-site SEO tools, and 1 custom domain per unit) is shown as a card with a Monthly/Annual billing-cycle toggle (Annual is marked Save 17%) and a quantity selector for how many units to add.
  • Buy Add-on opens Razorpay's hosted Checkout to activate it; once active, the card shows an Add Another App option to buy more units.
  • Appointments is the single-purchase exception. Its card shows Quantity: 1 Appointments add-on with no quantity selector. While active it shows Appointments add-on active and does not show Add Another App; a duplicate request is refused with The Appointments add-on is already active.
  • Cancel Add-on opens a confirmation dialog. Every add-on with an identifiable future paid-period end stays active until that date and stops renewal; the scheduled card then hides Cancel Add-on. Free, complimentary/non-billable, missing-price, and undated legacy grants can cancel immediately when no paid boundary can be found.

Monthly add-ons on an annual plan

If your store plan is Annual and you select Monthly on an add-on card, the first purchase is a full month at the displayed monthly base price, plus GST where applicable. It is not prorated to, or bundled into, the store plan's annual renewal. The add-on card shows Renews on [date], one calendar month after purchase, and future renewals charge the saved default payment method monthly on that own date.

On a Monthly store plan, a Monthly add-on keeps the existing plan-aligned behaviour: the first charge is prorated to the plan's next renewal date, then the add-on renews with the plan. The separate schedule applies only to the Monthly add-on + Annual plan combination.

If the own-date renewal cannot use a saved default payment method or its charge fails, the add-on keeps working for a 48-hour grace period. It retries once after 24 hours. If that retry does not succeed, only that add-on is paused; select Buy Add-on on its card and complete the purchase again to restart it.

When grace starts, BillionBiz sends one [Add-on name] renewal payment failed message to the store's point-of-contact email. It says the saved method could not be charged, gives the grace-end date, confirms the add-on keeps working while payment is retried, and directs you to update the card under Billing. If grace ends unpaid, one [Add-on name] paused email says the add-on paused, your plan and the rest of the store are unchanged, and you should check the card under Billing before buying the add-on again. A successful add-on renewal does not send a separate success email.

Selecting Cancel Add-on schedules every add-on with a future paid-period end, not only Appointments. The add-on keeps working until that date and is excluded from later renewal charges. The card changes from Renews on [date] to Cancelled · active until [date] and removes Cancel Add-on. A monthly add-on on an annual plan ends on its own monthly date, not the plan's annual renewal date. When cancellation is scheduled and the service returns that date, the success message says Add-on cancelled. It keeps working until [date].

If a non-Appointments add-on row has no date, the dialog says Cancel your <add-on name> add-on? If you've paid for the current period, it keeps working until that period ends. The Appointments fallback instead says Cancel your Appointments add-on? You will lose access at the end of the billing period. After confirmation, BillionBiz first tries to use the active plan's future end for a priced add-on. It cancels immediately only when no paid period can be identified: the add-on is free or has no price, the account or grant is complimentary/non-billable, or an older paid record has no future add-on or active-plan end date. An immediate cancellation shows Add-on cancelled. If an undated cancellation resolves to the plan's future end, the success message includes that date instead.

Open Add-ons

Go to Settings → Billing & Plan → Add-ons.

Find the scheduled card

For a scheduled hosting or top-up add-on, check that Add Another App remains available. Appointments remains active without a buy-more action until its end date.

Select the available purchase action

For a scheduled hosting or top-up add-on, select Add Another App. For Appointments, wait until the displayed end date, then select Buy Add-on.

Complete the purchase

Complete the purchase for the selected add-on.

Check the result

A hosting or top-up purchase clears the scheduled cancellation, keeps the add-on active, and adds the newly purchased quantity. An Appointments purchase reactivates it at quantity 1.

My add-on stopped working

For a monthly add-on on an annual plan, the add-on can pause after a renewal charge fails, the 24-hour retry also fails, and the 48-hour grace ends. This restart path applies to every monthly add-on, not only Appointments.

Open Add-ons

Go to Settings → Billing & Plan → Add-ons.

Check the card

If the active badge has gone and the card shows Buy Add-on, the add-on is no longer active.

Select Buy Add-on

Select Buy Add-on.

Complete the purchase

Complete the purchase again to restart the add-on.

Why does the Appointments card show a date two days away?

During renewal grace, the Appointments card uses the 48-hour grace-end expiry for its Renews on [date] display. The retry still happens after 24 hours; the visible date is when Appointments will pause if renewal remains unpaid, not the annual plan's renewal date.

I was charged for a renewal but can't find the invoice

Payment is recorded before invoice creation, so a bookkeeping failure can leave the charge visible without its invoice. Do not repeat the renewal purchase to create another invoice.

Open payment history

On the classic skin, go to Settings → Billing & Plan → Plan & Billing → Billing History → Payments. On v2, go to Settings → Billing & Plan → overview → billing history → payments.

Match the payment

Match the successful renewal by date and amount.

Check the invoice lists

Check Invoices / tax invoices and the v2 invoices tab again.

Contact support

If the invoice is still missing, contact support with the charge date, amount, and payment type so the billing records can be reconciled.

If an add-on payment fails and a later retry succeeds, the purchase activates the add-on once. A full refund removes the quantity bought by that payment; a partial refund leaves the add-on active at its existing quantity. If a full refund leaves no units, the entitlement is cancelled. The card no longer shows an active badge or Add Another App; it returns to Buy Add-on.

Direct link to this tab

You can deep-link straight to this tab with ?tab=addons on the Billing screen's URL, on both the classic and v2 skins.

Cancelling your subscription

Currently a v2-only control

Cancelling your subscription from the Billing screen is only available on the newer v2 skin (overview tab), and only to Owner/Store Admin accounts — Vendor accounts don't see this option. There's no equivalent control on the classic skin's Billing screen yet.

On v2, a cancel subscription link opens a confirmation dialog explaining that your store will revert to the free plan at the end of the current billing period and you won't be charged again. Confirming with yes, cancel submits the cancellation immediately; keep plan dismisses the dialog without changing anything.

Choosing or changing your plan

Open the plan chooser

On the Billing screen, click View Plans. A dialog opens listing every available plan.

Choose monthly or annual billing

Annual billing works out cheaper per month. Selecting annual shows the effective monthly cost alongside the full annual amount billed at once, so the saving is immediately visible.

Pick your plan

Each option is labelled Upgrade, Downgrade, or Current so you always know where you stand relative to today's plan. Prices are shown for your selected billing cycle.

Review the switch summary

Before any payment, BillionBiz calculates your proration and shows, in order:

  • Credit from unused time on your current plan (only if there is any)
  • Any existing credit balance on your account (only if there is any)
  • The price of the new plan for the chosen cycle
  • Amount after credit — only shown when it differs from the plan price above, i.e. when credit actually reduced what you owe
  • GST @ N% — only shown for INR plans; the tax on the amount you're actually being charged today (after credit), not on the full plan price
  • Amount to pay — the final total, GST-inclusive, below a divider

If the proration results in excess credit — for example when switching to a cheaper annual plan partway through a month — that credit stays on your account and reduces your next renewal, and no GST line is shown (there's nothing to tax).

Pay securely

Select Continue to Payment (or Pay [currency] [amount]) to open Razorpay's hosted Checkout. Choose any payment method Razorpay presents for your account and complete the payment there. BillionBiz does not collect card fields or show an optional card-saving control in its own dialog. Closing Checkout returns without a charge and shows Checkout closed. No payment was made. The in-app Plan Switch Summary remains the place to review New plan price, any Amount after credit, GST, and the final amount before Razorpay opens. The methods inside hosted Checkout are controlled by Razorpay and the account's configuration, not by a fixed list in BillionBiz.

As soon as payment is confirmed, your plan switches immediately and your new features and limits are available at once.

What happens when you downgrade

If you select a lower-tier plan and your current usage exceeds what that plan allows, BillionBiz shows a Downgrade Impact screen before proceeding. It lists every limit you would exceed — for example, if you use 800 product slots but the target plan allows 500. You must read and acknowledge the impact before the switch completes.

Each exceeded limit expands into two lists, and it is worth knowing exactly how they are built:

  • Will remain active — the items the target plan still has room for. They are kept in the order they were created, oldest first — matching what actually happens after the switch, because the platform locks your newest items first and restores your oldest items first. Your longest-standing items are the safest ones.
  • Will be disabled — everything from the point where the plan's allowance runs out.

The split is measured in the same units as the limit itself, not in rows on screen. For products that matters: each product counts one slot per sellable SKU, so a product with three colour variants uses four slots, not one. A single variant-heavy product can therefore be the one that crosses the line, and you may see a product with many variants marked for disabling while several simpler products after it stay active. That is the allowance being spent, not an ordering mistake. The summary line above each list always reports slots; the list headings report how many actual items are in the list below them.

Each list shows only the first few items inline, with a "+ N more" line underneath. If you are over a limit by a large amount there is a second, larger cut behind that: the panel is sent at most 50 affected items (oldest first) no matter how far over you are, and it tells you when that has happened. So on a store hundreds of items over its cap, the "+ N more" figure counts what is left of those 50 — not the full remainder. The slot counts on the summary line above each list are never capped and are always your real totals.

Your data is never deleted

On a downgrade, anything over the new plan's limit simply becomes locked and inactive — it is not removed. Upgrading again immediately restores it.

If your subscription lapses

Subscriptions can enter a short Grace Period if a renewal payment fails — for example, a saved card expires. During the grace period, your store and all your data remain fully intact and the admin panel stays accessible. A notice on the Billing screen explains the situation and prompts you to update your payment method or renew.

If the grace period expires without payment, the subscription moves to Suspended — the store goes temporarily offline, but nothing is deleted. Resolving billing restores everything immediately.

Plan grace and add-on grace are separate

This subscription state is different from a failed own-date renewal for a Monthly add-on on an Annual plan. That add-on stays active for its own 48-hour grace and then pauses by itself; the store plan does not move to Suspended because of that add-on charge. Restart the add-on from Settings → Billing & Plan → Add-ons → Buy Add-on.

v2 status alerts

The classic admin-panel skin shows dedicated banners for Past Due, Suspended, and Expired states in addition to the Grace Period notice. On the v2 skin, the plan-status pill at the top of the Billing screen now shows a distinct color and label for every one of these states too (previously it only styled Active correctly) — but its explanatory subtitle line still only writes bespoke wording for Grace Period and Cancelled, defaulting to ordinary "active" phrasing for Past Due, Suspended, or Expired. If you're on the v2 skin, rely on the pill's color/label — or switch to the classic skin — to be sure of your exact status.

Paying for BillionBiz itself

Everything above is about your own subscription fee to BillionBiz — a separate, distinct transaction from the payments your customers make on your store. For how customer payments flow to your bank account, see Finance: Payouts, Settlements & Invoicing.

Next steps