How to Sell IPTV with WHMCS in 2026: Step-by-Step Billing Setup
To sell IPTV with WHMCS, run self-hosted WHMCS, connect your panel through a provisioning module, and let invoices drive line creation, renewal and suspension.
To sell IPTV with WHMCS, you run a self-hosted WHMCS installation, connect it to your IPTV panel through a provisioning module, and let WHMCS invoices drive line creation, renewal and suspension on the panel. This guide is for operators who already hold distribution rights for the channels they sell and want billing off spreadsheets and manual panel work. The steps apply to WHMCS 8.13 and 9.x as of November 2026.
Key takeaways
- You need distribution rights for every channel you sell. A billing module automates invoices and line provisioning; it does not make content legal to resell.
- IPTV panel modules are third-party provisioning modules, so they need self-hosted WHMCS. WHMCS Cloud does not currently support custom modules.
- Build one product per plan, use billing cycles for 1, 3, 6 and 12 months, and use configurable options for connections and channel packs.
- Suspension, unsuspension and termination come from Automation Settings, and only work while the cron runs every 5 minutes.
- Read your payment processor's acceptable use policy before launch, and test a full create, suspend, pay and renew cycle on a real panel account.
What do you need before you sell IPTV with WHMCS?
Selling IPTV with WHMCS needs five things in place before you build a product:
- Distribution rights. You need a license or written authorization for each channel and on-demand title you sell, either from the rights holders or from a provider that can show it holds them. Payment processors check this too: Stripe's restricted businesses list bars the sale of films or other licensed material without authorization.
- Self-hosted WHMCS. WHMCS states that custom modules apply to self-hosted installations only and that WHMCS Cloud does not currently support them.
- A supported PHP version. WHMCS 9.0 and 9.1 require PHP 8.2 or later, and 9.1 supports PHP 8.2, 8.3 and 8.4 according to the system requirements. WHMCS lists December 31, 2026 as the end of life for 8.13. WHMCSPilot's IPTV module pages list compatibility with WHMCS 8.13 and PHP 8.1+, so confirm 9.x support for your module before you upgrade.
- A working cron. WHMCS needs its system cron to run at least every 5 minutes, for example
*/5 * * * * php -q /path/to/whmcs/crons/cron.php. Without it, no suspension or renewal invoice ever fires. - Panel API access. Either an admin API key on a panel you run, or reseller credentials with API access on a panel someone else runs, plus your WHMCS server's IP address allowed through the panel firewall.
Step 1: Which IPTV panel should you connect to WHMCS?
The right IPTV panel for WHMCS billing is usually the one your lines already live on, because moving subscribers between panels means new credentials and app setup for every customer. WHMCSPilot sells a provisioning module for four panels, each listed at $99:
| Panel | WHMCSPilot module | Automation listed on the module page |
|---|---|---|
| XUI.one | XUI Panel Module | Account provisioning, package assignment, suspension and termination, client area features, API integration |
| Xtream UI | XTREAM UI Panel Module | Line provisioning, package and bouquet assignment, credit system integration, reseller account management, multi-server support, custom field mapping |
| NXT | NXT IPTV Panel Module | Account provisioning, suspension on non-payment, credit-based or subscription billing, bouquet and package management, status sync, bulk operations |
| Strong8K | Strong8K Panel Module | Account lifecycle automation, package management, automatic renewal and suspension, client portal integration, multi-server support |
Starting fresh, pick the panel whose API you can get documentation and test credentials for. All four modules, plus a standalone billing alternative, are listed in the IPTV modules category.
Step 2: How should you structure IPTV products in WHMCS?
IPTV products in WHMCS work best as one product per plan, with subscription lengths set as billing cycles rather than as separate products. A customer who moves from monthly to annual then stays on the same service, and the line keeps its credentials.
- Go to
Configuration > System Settings > Products/Servicesand create a product group such as "IPTV Subscriptions". The path is the same in WHMCS 8.13 and 9.x. - Click Create a New Product, choose the Other product type, name the plan and select your panel module.
- On the Pricing tab, set Payment Type to Recurring and enter prices for Monthly, Quarterly, Semi-Annually and Annually.
- On the Custom Fields tab, add a "MAC Address" text box for MAG or set-top box customers, tick Show on Order Form and Required Field, and add a validation rule such as
/^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$/. - On the Details tab, choose a welcome email. Rewrite the default hosting template for streaming: line credentials, playlist and guide instructions, and links to device setup articles.
Step 3: How do you set up connections and channel packs as configurable options?
Configurable options in WHMCS let customers change a product's price by choosing extras, which suits IPTV connection counts and channel packs. You create them in groups at Configuration > System Settings > Configurable Options and assign each group to one or more products.
| Option | Type | Example sub-options | Maps to on the panel |
|---|---|---|---|
| Connections | Dropdown | 1|1 screen, 2|2 screens, 4|4 screens | Maximum concurrent connections on the line |
| Channel pack | Dropdown or Radio | 12|Sports, 15|Movies | Bouquet ID or package |
| Extra device | Yes/No | One sub-option with a price per cycle | An added connection, if your panel supports it |
The value|display format is a WHMCS feature called friendly display names: customers see the text after the pipe on the order form, emails and invoices, while the module receives the value before it. Modules differ in whether they read the connection count from a configurable option or from the panel package, so check the module settings first. If yours only maps packages, create one product per panel package instead.
Step 4: How do you offer an IPTV free trial in WHMCS?
An IPTV free trial in WHMCS can run on core features. WHMCS documents an auto-terminating free trial: on the product's Pricing tab, enter the trial length in days for Auto Terminate/Fixed Term, set Payment Type to Free (or keep a paid type, paired with a 100% promotion code, to collect payment details for fraud checks), and pick a Termination Email. Trials attract abuse, so limit them. WHMCSPilot's WHMCS Trial Module adds free or paid trials, auto-conversion or auto-suspension at trial end, reminder emails, and fraud guards of one trial per IP, email or payment method. On the panel, keep trial lines on one connection and a small channel set.
Step 5: How do you install an IPTV panel module in WHMCS?
Installing an IPTV panel module follows the standard WHMCS provisioning module pattern. The module's instructions give the exact folder name; the general sequence is:
- Upload the module files to
/modules/servers/in your WHMCS root, using the folder name the module documentation gives. - Go to
Configuration > System Settings > Servers, click Add New Server and select the IPTV module. - Enter the panel hostname or URL and the API key or reseller credentials, then click Test Connection.
- Edit your IPTV product, open Module Settings, select the module and server, and choose Automatically setup the product as soon as the first payment is received. The "as soon as an order is placed" option provisions before payment, a poor default for IPTV.
- Save, place a test order with a 100% promotion code, and confirm the line appears on the panel.
Step 6: How do you map WHMCS products to panel packages?
Package mapping tells the module which panel package, bouquets and limits belong to each WHMCS product. Write it down first, since later catalog changes start from this table:
| WHMCS product | Panel package | Connections | Bouquets |
|---|---|---|---|
| Basic | Basic package | 1 | General entertainment |
| Family | Family package | 2 to 4 (configurable option) | General, kids, sports |
| Trial | Trial package | 1 | General entertainment only |
The WHMCSPilot module pages describe mapping in different words: package assignment for XUI.one, package and bouquet assignment plus custom field mapping for Xtream UI, bouquet and package management for NXT, and package management for Strong8K. After mapping, order each product once and compare the resulting line on the panel against the table.
What should customers see in the client area?
The WHMCS client area shows module output on the product details page through the module's ClientArea function, so line details sit next to invoices and tickets. Each WHMCSPilot IPTV module lists client area integration, but what it displays varies, so check its demo or documentation. Customers usually need:
- Server URL, username and password
- The M3U playlist link and XMLTV guide link, if your panel generates them
- Expiry date and connection limit
- Links to setup articles for each app and device you support
How do renewals and suspension on non-payment work?
Renewals and suspensions in WHMCS are driven by each service's Next Due Date and the settings at Configuration > System Settings > Automation Settings, the same path in 8.13 and 9.x. The provisioning module turns each WHMCS event into a panel action:
| WHMCS event | Module function | Result on the panel |
|---|---|---|
| First invoice paid | CreateAccount | Line created with the mapped package |
| Renewal invoice paid | Renew | Expiry extended |
| Overdue past Suspend Days | SuspendAccount | Line disabled |
| Overdue invoice paid | UnsuspendAccount | Line enabled again |
| Overdue past Termination Days | TerminateAccount | Line removed |
Settings that suit IPTV:
- Invoice Generation: WHMCS defaults to 14 days before the due date. Under Advanced Settings you can set a shorter lead time for Monthly, such as 5 to 7 days.
- Enable Suspension with Suspend Days of 1 to 3, plus Enable Unsuspension so that paying restores the line.
- Enable Termination with Termination Days long enough to win back late payers, such as 14 to 30.
- On-Demand Renewals on the Ordering tab of
General Settings, so customers can renew before the invoice is generated.
One detail causes most expiry complaints. WHMCS moves the Next Due Date forward from its previous value, so paying late does not shift the renewal date, and a customer suspended for five days loses those days. Check whether your module sets the panel expiry from the WHMCS due date or adds days to the panel's current expiry, and tell customers which rule applies.
Which payment gateways work for IPTV billing in WHMCS?
Payment gateways in WHMCS are activated at Configuration > Apps & Integrations under the Payments category, in both 8.13 and 9.1. WHMCS includes Stripe, PayPal, bank transfer and many others. Card processors review IPTV merchants closely, so describe your business accurately during onboarding and keep your licensing documents ready. WHMCSPilot's payment gateway modules add:
- NOWPayments: Bitcoin, Ethereum, USDT and 100+ cryptocurrencies, with automatic payment verification
- Square and Clover: card payments with recurring billing support
- CashApp: CashApp payments for US customers, with automatic or manual reconciliation
- Helium: HNT paid straight to your wallet and verified on-chain
How do you handle IPTV customer support in WHMCS?
IPTV support tickets cluster around device setup, playback problems and expiry questions. WHMCS covers them with support departments, knowledgebase articles and service data on each ticket:
- Create departments for Setup, Billing and Technical so tickets reach the right person.
- Publish one knowledgebase article per app or device, and link them from the welcome email.
- Check
Utilities > Module Queuedaily. It lists failed module actions, such as a line that was not created because the panel was unreachable or a reseller balance ran out. WHMCS does not retry these on its own. - If your customers live in chat apps, WHMCSPilot's Telegram and Discord bots let them check invoices, see service status, open tickets and request renewals from the app.
IPTV launch checklist for WHMCS
- A test order creates a line with the right package, connections and bouquets.
- A trial line is created and terminated on schedule.
- An overdue test service is suspended on the panel and restored after payment.
- A paid renewal extends the panel expiry to match WHMCS.
- If you sell upgrades, an upgrade changes connections on the existing line (WHMCS calls the module's
ChangePackagefunction). - Every customer email has been read through with real data in it.
Frequently asked questions
Can I sell IPTV on WHMCS Cloud?
Not with a third-party panel module. WHMCS states that WHMCS Cloud does not currently support custom modules, so IPTV panel integrations need a self-hosted installation.
Do I need a separate module for each IPTV panel?
Yes. Each panel has its own API, so WHMCSPilot sells separate modules for XUI.one, Xtream UI, NXT and Strong8K, and one WHMCS installation can run several of them with each product assigned to the right one.
When is the IPTV line created after payment?
With "Automatically setup the product as soon as the first payment is received" selected, WHMCS runs the module's create function when payment for the new order is recorded. Crypto payments wait until the gateway confirms the transaction.
What happens to an IPTV line when a customer does not pay?
With Enable Suspension on, the cron suspends the service after your Suspend Days setting and the module disables the line on the panel. Paying the overdue invoice restores it if Enable Unsuspension is on, and Termination Days decides when the line is removed.
Does WHMCS make IPTV reselling legal?
No. WHMCS and panel modules automate billing and line provisioning only. You need distribution rights for every channel you sell, and processors such as Stripe prohibit selling licensed material without authorization.
If you would rather have the integration installed, mapped and tested for your panel, WHMCSPilot's IPTV provisioning service covers it. For a billing system built only for IPTV, see the IPTV Billing Portal.