Subscriptions

Subscriptions bill a customer again and again on a fixed cycle: monthly hosting, an annual support contract, a weekly delivery, a retainer. NaliSuite issues each renewal invoice by itself, emails it, chases it when it is late, and works out the difference when a customer moves to a bigger or smaller plan. Hosting companies can also create, suspend and remove cPanel accounts automatically. You find this under Finance → Subscriptions and Finance → Recurring revenue; the settings are in Settings → Preferences → Subscriptions.

What you need before you start

You want to Permission needed
See subscriptions and recurring revenue subscriptions.view
Create, start, change, pause, cancel subscriptions; import from WHMCS; manage hosting subscriptions.manage
Export subscriptions.export

The Invoicing app must be on, because every renewal is an invoice.

Plans are recurring products

A "plan" is simply a product with a billing cycle.

  1. Open Sales → Products and create (or open) a service, for example "Cloud VPS 6 (monthly)".
  2. In Pricing, set Billed every (marker 1) to Week, Month, Quarter or Year, and the Sale price (marker 2) per cycle.
  3. Save.
Product pricing with Billed every and Sale price marked
Product pricing with Billed every and Sale price marked

Recurring products are listed first when you add lines to a subscription, are the choices in Change plan, and are what customers may switch between in the portal (only plans with the same cycle). See Products and pricing.

How a subscription moves through its life

Status Meaning What moves it
Draft Set up, not started. No number, nothing billed. Everything editable; can be deleted. Start.
Trial Started with a free period (Free until in the future). Not billed until the trial ends. The first billing run after the trial.
Active Running and billed each cycle. Billing continues; Pause, Cancel, or an unpaid renewal.
Past due A renewal invoice is overdue. Hosting can be suspended. Back to Active at the next renewal billing, and hosting is unsuspended.
Paused Billing stopped for now. Resume.
Cancelled Ended. Final.

When a subscription is cancelled "at the end of the paid period", it stays active with Ends at period end until that date, then ends at the next billing run.

Find your way around the subscription list

  1. In the menu, open Finance → Subscriptions.
Subscriptions list with New subscription, Import from WHMCS, the Past due tab and the Monthly value column marked
Subscriptions list with New subscription, Import from WHMCS, the Past due tab and the Monthly value column marked
Item What it does
New subscription (marker 1) Opens a new draft subscription.
Import from WHMCS (marker 2) Imports customers, plans and services from a WHMCS export. See Move from WHMCS.
Tabs Active (default: active, trial and past due), Past due (marker 3), Draft, Paused or cancelled, All
Monthly value (marker 4) What the subscription is worth per month, whatever its cycle (an annual KES 12,000 plan shows KES 1,000).
Filter Status, Customer.

Other columns: Number (SUB-00001), Name with the customer underneath, Every (the cycle), Next invoice date, Paid until and Status. The list is sorted by next invoice date, so the next renewals are at the top.

Create and start a subscription

  1. Open Finance → Subscriptions and click New subscription.
  2. Type a Name, for example "Shared hosting, annual · Savanna Logistics", and pick the Customer (click + to add a new one).
  3. Choose Billed every (marker 1) and the Interval count (marker 2): Month and 1 for monthly, Month and 6 for every six months.
  4. Set Starts (the first day of the first period). For a free trial, set Free until (marker 3).
  5. Set Invoice days before renewal (marker 4) if customers should get the invoice in advance, for example 7.
  6. Keep or switch off Email each renewal invoice automatically and Customer may change or cancel it in the portal (marker 5).
New subscription form with Billed every, Interval count, Free until, Invoice days before renewal and the portal self-service switch marked
New subscription form with Billed every, Interval count, Free until, Invoice days before renewal and the portal self-service switch marked
  1. Under What is billed each period, pick the Product (marker 2) and check the Qty, Price and Tax. Add more lines with Add to lines (marker 3), for example a plan plus an add-on. For hosting, open Hosting account (cPanel) (marker 1).
Lines of a subscription with the Hosting account section, Product and Add to lines marked
Lines of a subscription with the Hosting account section, Product and Add to lines marked
  1. Click Create. The subscription is saved as a Draft.
  2. Check it, then click Start at the top and confirm. It gets its number, becomes Active (or Trial), and its first invoice is issued at the next nightly billing run, or straight away if the start date has passed.

Every field on the subscription

Field What to enter
Name (required) What the customer is subscribed to. Appears on renewal invoices.
Company (required) Locked once started.
Customer (required) Locked once started.
Billed every (required) Week, Month, Quarter or Year. Locked once started (use Change plan to move between plans).
Interval count (required) 1 to 36 cycles per period. Locked once started.
Starts (required) First day of the first period. Locked once started.
Free until Last day of a free trial. Empty for no trial. Locked once started.
Invoice days before renewal Issue each renewal invoice this many days before the new period starts (0 to 60). The default is in Preferences → Subscriptions.
Currency (required) Locked once started.
Payment terms (days) How long the customer has to pay each renewal. Sets the due date of renewal invoices.
Salesperson For commission and reports.
Email each renewal invoice automatically Each renewal invoice is emailed to the customer as soon as it is issued (also needs the Preferences switch on and an email on the customer).
Customer may change or cancel it in the portal Allows self-service upgrades, downgrades and cancellation for this subscription (also needs the Preferences switches).
Hosting account (cPanel): Domain, cPanel package, cPanel username See Provision cPanel hosting automatically.
Lines: Product, Description (required), Qty (required), Price (required), Tax What is invoiced every period.
Notes Internal.

How renewals are billed

Every night at 02:30 the billing run looks at every active, trial and past-due subscription whose Next invoice date has arrived. For each one it:

  1. Creates an invoice for the coming period, with the subscription's lines, the period dates in the notes ("Shared hosting · 1 Dec 2026 to 30 Nov 2027") and the subscription number as the customer reference.
  2. Issues it straight away (number, ledger posting, e-invoicing as for any invoice).
  3. Emails it to the customer when automatic sending is on.
  4. Moves Paid until and Next invoice forward by one period.

To bill early, open the subscription and click Invoice now: the next period's invoice is issued immediately and opens. Renewal invoices are ordinary invoices: customers pay them with the pay link or in the portal, and you record payments as usual. See Invoices and payments.

When a renewal invoice is overdue, the daily reminder run emails the customer and marks the subscription Past due; with Suspend hosting when a renewal goes past due on, its cPanel account is suspended too. It returns to Active (and hosting is unsuspended) at its next renewal billing.

Manage a running subscription

Open the subscription. The header shows what you can do:

Subscription header with Invoice now, Change plan, Pause and Cancel marked
Subscription header with Invoice now, Change plan, Pause and Cancel marked
Action When it shows What it does
Start Draft Starts it; see above.
Invoice now (marker 1) Active, trial or past due Issues the next period's invoice now.
Change plan (marker 2) Active, trial or past due Moves it to another recurring product, with proration.
History After any change Shows every plan change, cancellation and reactivation with who did it (staff, customer or import) and the monthly value before and after.
Provision hosting / Suspend hosting / Unsuspend hosting Hosting subscriptions with WHM set up Acts on the cPanel account by hand.
Pause (marker 3) Active, trial or past due Stops billing.
Resume Paused Starts billing again from today.
Cancel (marker 4) Active, trial, past due or paused Ends it, by default at the end of the paid period.
Delete Draft Deletes the draft.

Change plan with proration

  1. Click Change plan.
  2. Choose the New plan (marker 1). Each option shows its price and cycle.
  3. Check the Quantity (marker 2).
  4. Keep Prorate the rest of this period (marker 3) on to charge or credit the difference now. Switch it off to change only from the next renewal.
  5. Click Submit.
Change plan window with New plan, Quantity and Prorate the rest of this period marked
Change plan window with New plan, Quantity and Prorate the rest of this period marked

With proration, the customer pays the new plan for the days left in the current period and is credited the old plan for the same days:

Example: a customer on a KES 1,800 monthly plan moves to a KES 3,000 plan halfway through the month. They are invoiced about KES 600 (half of 3,000 less half of 1,800). From the next renewal they pay KES 3,000.

The subscription's lines and name follow the new plan, the change is logged in History, and with cPanel hosting the account is moved to the package named like the new product.

Cancel a subscription

  1. Click Cancel.
  2. Leave End immediately (marker 1) off to end it when the paid period finishes (the usual choice: the customer keeps what they paid for). Switch it on to end it today.
  3. Click Confirm.
Cancel window with the End immediately switch marked
Cancel window with the End immediately switch marked

With hosting, the cPanel account is suspended when the subscription ends, or removed if Remove the cPanel account when a hosting subscription ends is on. Cancelling does not credit anything automatically; issue a credit note from the last invoice if you are refunding.

Pause and resume

Pause stops billing while, for example, a client's shop is closed for renovation. The subscription moves to the Paused or cancelled tab. Open it and click Resume (marker 1) to restart billing from today.

Paused subscription with the Resume button marked
Paused subscription with the Resume button marked

What customers can do in the portal

When the portal shows subscriptions (Preferences → Customer portal → Show subscriptions to customers) and the subscription allows self-service, customers see their subscriptions in the portal and can:

Your team gets a "Subscription changes" notification for each change, and it is logged in History. See Customer and vendor portal.

Provision cPanel hosting automatically

If you sell web hosting on a cPanel/WHM server, NaliSuite can run the accounts for you.

  1. In WHM, go to Development → Manage API Tokens and create a token.
  2. In NaliSuite, open Settings → Preferences → Subscriptions and fill in cPanel / WHM: WHM URL (for example https://server.example.com:2087), WHM user (usually root) and API token. Save.
  3. On each hosting subscription, open Hosting account (cPanel) and fill in:
Hosting account section with Domain, cPanel package and cPanel username marked
Hosting account section with Domain, cPanel package and cPanel username marked
Field What to enter
Domain (marker 1) The customer's domain, for example example.co.ke. Filling it makes this a hosting subscription.
cPanel package (marker 2) The WHM package name, for example "starter".
cPanel username (marker 3) Leave empty to have one made from the domain. Afterwards it shows the account Status and the last error, if any.

What happens automatically:

When On the server
The subscription starts The cPanel account is created.
A renewal goes past due (with Suspend hosting when a renewal goes past due on) The account is suspended.
It becomes active again The account is unsuspended.
The plan changes The account moves to the package named like the new plan.
The subscription ends The account is suspended, or removed when Remove the cPanel account when a hosting subscription ends is on.

Use Provision hosting, Suspend hosting and Unsuspend hosting on the subscription to do the same by hand, for example to retry after an error.

Move from WHMCS

  1. In WHMCS, export Products/Services as CSV with a header row. The columns used are: id, firstname, lastname, email, companyname, product name, domain, billingcycle, amount, nextduedate, regdate, status, username and packagename.
  2. In NaliSuite, open Finance → Subscriptions and click Import from WHMCS.
  3. Choose the Company and upload the file in Products/Services CSV (marker 1). Click Submit.
Import from WHMCS window with the file upload marked
Import from WHMCS window with the file upload marked

For each row, the customer is found by email or created, the plan is found by name or created as a recurring product, and the subscription is created or updated (matched on the WHMCS id, so you can import again safely). Billing cycles map to NaliSuite cycles (Semi-Annually becomes every 6 months, Biennially every 2 years); WHMCS statuses map as Active → Active, Suspended → Paused, Terminated/Cancelled/Fraud → Cancelled, Pending → Draft. The next due date becomes the next invoice date, and the domain, username and package fill the hosting fields. The message at the end says how many were created, updated and skipped, with the first errors (for example "Row 7: needs an email and a product name").

Tip: Import with automatic sending off in Preferences, check the next invoice dates, then switch it back on.

Track recurring revenue and churn

Finance → Recurring revenue shows how the subscription business is doing.

Recurring revenue page with MRR, Churn last month and the Last twelve months table marked
Recurring revenue page with MRR, Churn last month and the Last twelve months table marked
Figure Meaning
MRR (marker 1) Monthly recurring revenue: every billable subscription's value per month, before tax, at today's plan.
ARR MRR × 12.
Active, On trial, Past due, Paused How many subscriptions are in each state.
Average per customer MRR divided by the number of live subscriptions.
Churn last month (marker 2) Subscriptions that ended last month as a percentage of those active at the start of the month.
Last twelve months (marker 3) Month by month: MRR, Net new MRR, Active, New, Churned, Upgrades, Downgrades and Churn rate.

Choose the company at the top when you have more than one.

Subscription preferences

Settings → Preferences → Subscriptions:

Subscriptions preferences with the portal plan switch, the past-due suspension switch, the cPanel/WHM fields and the payment reminder schedule marked
Subscriptions preferences with the portal plan switch, the past-due suspension switch, the cPanel/WHM fields and the payment reminder schedule marked
Setting What it does
Email renewal invoices automatically Master switch for emailing renewal invoices.
Customers may switch plans in the portal (marker 1) Between recurring products billed on the same cycle; the difference is invoiced or credited.
Customers may cancel in the portal Always at the end of the paid period; they can undo it until then.
Suspend hosting when a renewal goes past due (marker 2) Suspends the cPanel account of a past-due hosting subscription.
Remove the cPanel account when a hosting subscription ends Off: the account is suspended and kept until you remove it by hand.
cPanel / WHM (marker 3) WHM URL, WHM user, API token.
Invoice renewals this many days before the period starts Default for new subscriptions.
Payment reminder schedule (marker 4) Days relative to the due date for reminder emails on every invoice, for example -3, 1, 7, 14. See Invoices and payments.

Common questions

The first invoice was not created when I clicked Start. It is issued at the next nightly billing run unless the start date has already passed. Use Invoice now to bill at once.

Can I change the price of a running subscription? Use Change plan to move it to another product, or edit the line's Price on the subscription; the new price applies from the next renewal.

Why can't I change Billed every? The cycle is locked once a subscription starts. Cancel it at period end and start a new one, or change plan.

A customer paid but the subscription still says Past due. It returns to Active at its next renewal billing. Hosting is unsuspended then; use Unsuspend hosting to do it now.

Customers cannot see their subscriptions in the portal. Switch on Preferences → Customer portal → Show subscriptions to customers.

Hosting status shows an error. The last WHM error is shown under cPanel username. Check the WHM URL and token, then use Provision hosting again.