• Release
  • v1.4
Docs

September 15, 2026

WHMCS VoIP Billing: A Complete Guide for Service Providers

Last Updated: September 15, 2026 | Reading Time: 7 minutes

If you run a VoIP service provider business, billing is one of the most complex and error-prone parts of your operation. This guide explains how to use WHMCS with FusionPBX and FS PBX to automate VoIP billing end-to-end, reduce manual work, and improve cash flow.

Whether you are switching from a legacy solution such as A2Billing or building a new VoIP platform from scratch, a well-integrated billing workflow is essential.

Why WHMCS for VoIP Billing?

WHMCS is the leading billing and client management platform for web hosting and telecom providers. By adding the right addon, you can turn WHMCS into a complete VoIP billing solution.

Key Benefits

  • Client Management: One customer record for hosting, VoIP, and support.
  • Automated Invoicing: Generate and send invoices on recurring cycles.
  • Payment Gateway Support: Accept credit cards, PayPal, bank transfers, and more.
  • Product Catalog: Sell VoIP packages like any other WHMCS product or service.
  • Multi-Currency & Tax: Bill international customers in local currencies with correct tax rules.
  • Support Integration: Billing and support tickets live in one system.

How VoIP Billing Works in WHMCS

The basic billing flow for a WHMCS-based VoIP platform has four steps:

Step Description What ictVoIP Billing Does
1. CDR Collection Pull call detail records from your PBX Automated collection from FusionPBX and FS PBX
2. Tariff Matching Match each destination to a rate Cached tariff engine with CSV import/export
3. Rating Calculate the cost of each call Real-time rating and markup calculations
4. Invoicing Bill the customer Invoices generated in WHMCS automatically

What You Need Before You Start

To set up WHMCS VoIP billing, make sure you have the following in place:

  • A working WHMCS installation (PHP 8.x)
  • A supported PBX platform: FusionPBX v5.3+ or FS PBX
  • The ictVoIP Billing addon for WHMCS
  • Rate decks in CSV or a supported import format
  • Customer data, including service assignments and extensions

Step-by-Step Setup

1. Install the ictVoIP Billing Addon

Start by installing the ictVoIP Billing addon for WHMCS. The addon integrates directly into the WHMCS admin interface and adds the modules you need for FusionPBX and FS PBX management.

  • Upload the addon to modules/addons/ictvoipbilling
  • Activate it in WHMCS under Setup > Addon Modules
  • Enter your license key
  • Verify the system health check passes

For a detailed walkthrough, see our Installation Guide.

2. Add Your PBX Servers

In the ictVoIP Billing admin panel, add one or more FusionPBX or FS PBX servers. The addon supports multiple PBXs, so you can manage several platforms from one WHMCS installation.

  • Enter the server name, IP address, and API credentials
  • Test connectivity with the built-in health check
  • Repeat for each additional PBX

3. Create WHMCS Products for VoIP Services

Create WHMCS products or services for each VoIP package you sell. You can combine fixed monthly fees with usage-based billing.

  • Fixed fee: Monthly extension or tenant fee
  • Usage-based: Per-minute billing for outgoing calls
  • Hybrid: Base fee plus overage charges

Assign products to client services and link them to the correct PBX tenant or extension.

4. Import Tariffs and Rates

Upload your rate decks using the CSV import tool. ictVoIP Billing uses an in-memory tariff cache that makes rating fast even for large rate decks.

  • Prepare your CSV with destination, prefix, and rate
  • Import the file through the tariff management interface
  • Verify a few sample prefixes before going live
  • Set markup rules if you resell rates to customers

5. Enable CDR Collection

CDR collection is the core of automated billing. The addon pulls call detail records from your PBX on a regular schedule and matches them to your tariffs.

  • Configure the CDR import interval
  • Map PBX call records to WHMCS client services
  • Enable real-time statistics for visibility
  • Review the first few CDR batches for accuracy

6. Test and Go Live

Before billing real customers, run a test cycle:

  1. Create a test client and assign a service
  2. Make test calls on the PBX
  3. Wait for CDR import
  4. Review the call rating in WHMCS
  5. Generate a test invoice
  6. Confirm totals match expectations

Once the test is successful, switch to live billing.

Managing Multi-Tenant VoIP Billing

Many VoIP providers sell to resellers or franchise locations. With multi-tenant support, you can isolate tenants on FusionPBX and bill each one separately in WHMCS.

  • Create separate FusionPBX domains for each tenant
  • Link each domain to a WHMCS client service
  • Manage extensions, gateways, and routes per tenant
  • Generate per-tenant invoices and reports

This approach keeps billing clean and makes reseller relationships easy to manage.

Common VoIP Billing Mistakes

1. Manual CDR Processing

Manual CDR processing is slow, error-prone, and hard to scale. Automation is essential for any serious VoIP business.

2. Missing Tariff Markup

Forgetting to add markup to buy rates will eat your margins. Always define the full sell rate, not just the cost rate.

3. Outdated Rate Decks

International calling rates change frequently. Update rate decks monthly or quarterly to avoid under-billing.

4. No Testing Before Go-Live

Always test CDR import, rating, and invoicing with real call samples before live billing. A small mistake can create hundreds of incorrect invoices.

Frequently Asked Questions

Can I use WHMCS for VoIP billing without FusionPBX?

WHMCS is the billing platform, but you still need a PBX to produce CDRs. ictVoIP Billing supports FusionPBX and FS PBX. It does not support Asterisk or FreePBX.

How often are CDRs imported?

CDR collection can run as often as every few minutes, depending on your PBX configuration and cron schedule.

Does ictVoIP Billing support multi-currency?

Yes. It leverages WHMCS multi-currency support, so you can bill customers in different currencies with proper exchange rates and tax rules.

Can customers see their call history?

Yes. Call details can be exposed in the WHMCS client portal, depending on your product configuration.

Is there a demo or trial?

Yes, we offer a beta program. You can apply through our Resources page.

Conclusion

WHMCS VoIP billing gives service providers a professional, scalable way to manage VoIP customers, usage, and invoicing. By combining WHMCS with the ictVoIP Billing addon and a FusionPBX or FS PBX backend, you can automate the entire billing flow from CDR collection to invoice delivery.

If you are ready to move away from manual billing or legacy platforms, get started with the Installation Guide or watch our Video Tutorials.

Tags: WHMCS VoIP Billing, FusionPBX Billing, FS PBX Billing, VoIP CDR, VoIP Tariffs, Multi-Tenant VoIP, ictVoIP Billing

Share this article: Help other VoIP providers modernize their billing workflow!

← Back to Blog