How to Build a Fully Automated IPTV Billing System with WHMCS in 2026

Running an IPTV reseller business without automation is a full time job by itself. Every new subscriber needs an account created manually on your panel. Every renewal needs chasing. Every suspension needs logging in and clicking through your panel interface. Every credential reset is a support ticket you have to handle personally.
At 20-30 customers this is manageable. At 100+ it becomes unsustainable. This guide covers how to build a fully automated IPTV billing system using WHMCS so that orders, renewals, suspensions, and terminations all happen without manual intervention.

What You Need Before Starting
Before building the automation stack, make sure you have the following in place:
WHMCS Installation
WHMCS needs to be installed on a stable server with a valid SSL certificate. Version 8.x or 9.x is recommended. Make sure your PHP version matches WHMCS requirements — PHP 8.1, 8.2, or 8.3 are the most stable options currently.
An IPTV Reseller Panel Account
You need a reseller account on at least one supported IPTV panel — XUI ONE, NXT Dash, Xtream UI, or OneStream are the most common. Your panel needs API access enabled, and you need your API URL, username, and password or token ready.
A Payment Gateway
WHMCS needs at least one active payment gateway to process customer payments. Stripe is the most reliable option for recurring billing — it handles subscription retries automatically and works in most countries. More on gateway options later.
A Domain and SSL
Your WHMCS client area needs to be on a domain with a valid SSL certificate. Customers will be logging in to manage their subscriptions, so HTTPS is non-negotiable.

Step 1 — Install and Configure WHMCS
Install WHMCS on your server following their official documentation. The key configuration steps after installation:
General Settings

Set your company name, logo, and support email
Configure your default currency
Set invoice generation and due date rules
Enable automatic suspension for overdue invoices
Enable automatic termination for cancelled services

Cron Job Setup
This is the most critical step. WHMCS automation — renewals, suspensions, terminations, invoice generation — all runs through a cron job. Configure it to run every 5 minutes:
*/5 * * * * /usr/bin/php -q /path/to/whmcs/cron/cron.php
Replace /path/to/whmcs/ with your actual WHMCS installation path. Without this running correctly, nothing else in your automation stack will work.
Email Templates
Configure your email templates for:

New account welcome email (includes credentials)
Invoice generated
Invoice overdue reminder
Service suspended
Service terminated

These fire automatically based on your automation rules once everything is connected.

Step 2 — Add Your Payment Gateway
For IPTV businesses, PayPal is not recommended as a primary gateway — accounts in the streaming space get restricted frequently without warning. Better alternatives:
Stripe Checkout — Best for recurring billing. Handles failed payment retries automatically, supports most countries, and has a straightforward API.
Coinbase Commerce — For crypto payments. No chargebacks by design, works for customers in any country, and removes payment processor restrictions entirely.
Square — Good for US, UK, and Canada based businesses. More stable than PayPal for digital services.
Amazon Pay — Improves checkout conversion since customers pay with their existing Amazon account.
Install your chosen gateway module in WHMCS under Setup → Payment Gateways. Enter your API credentials and run a test transaction before going live.
Pre-built gateway modules for Stripe, Square, Amazon Pay, and Coinbase Commerce are available at WHMCSModules.org if you need ready-made integrations.

Step 3 — Install Your IPTV Provisioning Module
This is where WHMCS becomes an IPTV automation system rather than just billing software. A provisioning module connects WHMCS to your IPTV panel via API so that service actions in WHMCS trigger corresponding actions on your panel automatically.
For single panel setups:
If you run one panel type, install the dedicated module for that panel — XUI ONE, NXT Dash, or Xtream UI modules each provide deep automation for their specific panel.
For multi-panel setups:
If you run multiple panel types or plan to scale across panels, the OTT Master Panel for WHMCS handles all supported panel types from a single module installation. One interface manages XUI ONE, NXT Dash, Xtream UI, and OneStream panels simultaneously.
Installation process:

Extract the module package
Upload files to your WHMCS root directory — the package contains both addon and server modules combined
Set directory permissions to 755 and file permissions to 644
Go to WHMCS Admin → Setup → Products/Services → Servers
Add your panel as a new server, select the module type
Enter your panel API URL and credentials
Run the connection test before saving

Step 4 — Configure Your Products
With your panel connected, create WHMCS products that map to your IPTV service offerings:
Product Setup

Create a product group for your IPTV services
Add individual products per service type — monthly subscription, quarterly, annual
Set pricing per billing cycle
Under Module Settings, select your provisioning module and panel

Package Mapping
Map each WHMCS billing cycle to the corresponding package on your panel:

Monthly billing cycle → monthly panel package
Quarterly billing cycle → quarterly panel package
Annual billing cycle → annual panel package

Service Type Configuration
Configure whether the product provisions:

Streamline accounts (M3U username/password lines)
MAG device accounts (MAC address based provisioning)
Reseller accounts (with credit allocation)

Credential Settings
Set whether credentials are generated randomly by the module, supplied by the customer at checkout, or follow a custom format you define.

Step 5 — Configure Automation Rules
With products configured, set up your automation rules in WHMCS:
Invoice and Payment Automation

Invoice generation: X days before due date
Overdue reminders: day 1, day 3, day 5 after due date
Auto suspension: after X days overdue
Auto termination: after X days suspended

Service Automation
When a customer pays:

Service activates on panel automatically
Welcome email with credentials fires automatically
Service shows as active in client area immediately

When invoice goes overdue:

Reminder emails fire on schedule
Service suspends on panel after grace period
Customer notified of suspension automatically

When customer cancels:

Termination request processed
Account removed from panel automatically
Service marked terminated in WHMCS

Step 6 — Set Up Client Self-Service
One of the biggest time savers in a properly configured WHMCS IPTV setup is the client self-service area. When configured correctly, customers can handle common requests themselves without contacting support:

View their subscription credentials
Change their line password
Access their M3U playlist URL
View their portal URL and web TV link
Download IPTV apps
See their expiry date and renewal date
Update their bouquet selection (where supported)

Every one of these handled by a customer themselves is a support ticket you don't have to answer.

Step 7 — Test the Full Order Flow
Before going live, run a complete end-to-end test:

Create a test client account
Place a test order for your IPTV product
Complete a test payment
Confirm account is created on your panel automatically
Confirm welcome email with credentials is received
Log into the client area and verify all self-service options work
Simulate an overdue invoice and confirm suspension triggers
Pay the overdue invoice and confirm unsuspension triggers
Submit a cancellation and confirm termination triggers

Only go live after all seven steps pass cleanly.

What Full Automation Looks Like in Practice
Once everything is running correctly, your day-to-day involvement in subscription management drops to near zero:

New customers order, pay, and receive credentials without you touching anything
Renewals process automatically on payment
Overdue accounts suspend and reactivate themselves
Cancelled accounts terminate and clean up automatically
Customers reset their own passwords and access their own credentials

Your involvement shifts from manually managing every account to monitoring the system, handling edge cases, and growing the business.

Summary
ComponentWhat it doesWHMCSBilling, invoicing, client managementCron jobTriggers all automation on schedulePayment gateway moduleProcesses customer paymentsIPTV provisioning moduleConnects WHMCS to your panelClient areaCustomer self-service portalEmail templatesAutomated customer communication
Building this stack takes a few hours of setup. Once running, it handles hundreds of subscriptions automatically with no ongoing manual work required.

Built by the team at WHMCSModules.org — premium WHMCS automation modules for IPTV resellers and hosting businesses.