Billing
Tutorial covering account balances, invoices, statements and recurring charges
Detailed documentation for sections covered in this tutorial can be found at:
The Billing section is where you credit customers, turn usage and other charges into invoices, send those invoices, record payment, and issue statements.
Before you send invoices
Contact Support ([email protected]) to have billing enabled for your instance. Then complete Configuration > Company:
- Sales, support and invoice sender names, addresses and signatures
- Invoicing details — postal address, invoice-from email, bank / wire details, footer note, and the first invoice number (numeric, starting with 1, for example
10000). These invoicing fields are changed by Support. - Email templates — including invoice payment reminders
On each customer, complete the Billing tab (account code, payment terms, invoice email and postal address) as described in the Customers tutorial.
Account balances
Customers need credit to submit messages. The balance is on the customer account and is shared by all of that customer's SMPP accounts.
Go to Billing > Account balances.
The Balances table shows name, currency, balance, last updated time, and Prepay or Postpay.
- Currency None — SMS credits (one credit per accepted submit)
- A real currency — monetary balance; the destination price is deducted on accept
Add or remove credit
- In Pending Changes, click Add balance change.
- Select the customer.
- Enter a positive amount to credit, or a negative amount to debit.
- Enter a description (payment reference, test credit, goodwill, and so on).
- Click Save.
The change is applied within about one minute, then appears in Changes Audit Trail with the user who made it.
Use Change type to switch Prepay / Postpay and Change currency to change currency. Period audit trail lists every manual and message-driven change for a date range and customer.
Configure low-balance warning emails on the customer Balance tab.
Create invoices
Usage charges (MT SMS and similar) are collated into charge lines. You can also add manual charges. Invoices are created from those unassigned lines.
Add a manual charge
- Go to Billing > Create invoices.
- Click Create charge entry.
- Select the customer.
- Enter description, quantity, unit charge, currency, tax percentage, period and optional PO reference.
- Click Save.
Charge lines that are not yet on an invoice appear in this table. You can edit or delete them here.
Generate invoices
- Still in Billing > Create invoices, click Generate invoices.
- Confirm. Charge lines are grouped by customer, currency and PO reference into invoice documents.
- A dialog reports how many invoices were created (or that none were generated).
New invoices appear on the Pending tab in Billing > Invoices.
If no invoices are generated, typical causes are: there are no unassigned charge lines, or billing is not yet enabled for the instance.
Manage invoices
Go to Billing > Invoices. Tabs:
| Tab | Meaning | Typical actions |
|---|---|---|
| Pending | Newly created, not yet emailed | PDF, View, Email to the customer, Sent (mark as sent without emailing from the portal), Hold |
| Held | Parked for review | Edit, Unhold, View, Zero (set the grand total to zero), PDF |
| Unpaid | Emailed (or marked sent) and not paid | Paid, View, PDF. Totals are shown in the instance base currency. |
| Overdue | Past the due date and unpaid | Email reminder, Write off, PDF |
| All | Every invoice | View, PDF, Email to self. Monthly ZIP download is available from this tab. |
Due dates are invoice date plus the customer's Payment terms (days).
Send an invoice
- Open Pending.
- Click PDF to check the document.
- Click Email to send the PDF to the customer's invoice addresses, or Sent if you issued it outside the portal.
- The invoice moves to Unpaid.
Hold and correct
- On Pending, click Hold.
- On Held, click Edit to adjust details, Zero if the invoice should not be charged, or Unhold to return it to the workflow.
Record payment
On Unpaid, click Paid when the customer has paid. The paid date is stored and the invoice leaves the unpaid / overdue lists.
Overdue reminders
On Overdue, click Email reminder to send the reminder template. Write off removes the amount from collections (wo_ts).
Icons on unpaid and overdue rows show whether reminders are held for that customer or the account is on a hold-live status.
Statements
Go to Billing > Statements.
- Select the customer.
- The page shows Statement total, Account balance, and the list of balance transactions.
- Click Email statement to customer or Email statement to self.
Recurring charges
Go to Billing > Recurring.
- Click New recurring charge.
- Select the customer.
- Enter the description, quantity, charge definition, next run time and optional expiry.
- Click Save.
When a recurring charge falls due, a charge line is created and can be picked up the next time you click Generate invoices. Recurring service definitions used across customers are configured under Configuration > Company > Billing.
Reporting
Billing > Reporting includes:
- Unbilled and billed volumes — unbilled, billed and zero-revenue quantities over a date range (optional customer filter)
- Invoiced revenue (monthly) and Invoiced revenue (annual)
- Accuracy — actual message volume versus billed volume for recent months, with the difference and percentage
Use these after each billing run to confirm volumes match Reports and that nothing remains unbilled unexpectedly.
Troubleshooting
| Symptom | What to check |
|---|---|
| Generate invoices creates nothing | Unassigned rows must exist in Create invoices. Billing must be enabled for the instance (contact Support). |
| Invoice PDF is missing company or bank details | Configuration > Company invoicing details; ask Support to set fields you cannot edit. |
| Email invoice fails | Customer Send invoices to (email) is set; invoice sender and templates are configured; try Email to self from All. |
| Customer cannot send after going live | Prepay monetary or SMS-credit balance may be exhausted. Check Account balances and low-balance warnings. |
| Billed volume does not match Reports | Open Billing > Reporting > Accuracy. Differences should stay within the billed-volume accuracy standard. Check the invoice period and that charge lines used the expected completion timestamps. |
| Due date is wrong | Customer Payment terms (days) and the invoice date. |
If the issue remains, contact Support.
Updated 15 days ago
