Skip to content
IPTV

IPTV Automation in WHMCS: Renewals, Suspension, Sync and Notices

After launch, WHMCS can automate IPTV renewal invoices, suspension timing, panel expiry, reseller credit, trial expiry, notifications and cancellations, as long as the cron runs every 5 minutes.

WHMCSPilot Team Published Updated 9 min read
IPTV Automation in WHMCS: Renewals, Suspension, Sync and Notices

IPTV automation in WHMCS means the billing system, not your staff, handles everything that happens after a customer's first order: renewal invoices, reminders, suspension and unsuspension on the panel, expiry dates that match the panel, reseller credit, trial expiry, notifications and cancellations. This guide is for operators already selling IPTV through WHMCS. It applies to WHMCS 8.13 and 9.x; for the first product and panel setup, start with how to sell IPTV with WHMCS.

Key takeaways

  • Every IPTV automation in WHMCS depends on the cron running every 5 minutes.
  • Suspension, unsuspension and termination timing comes from Configuration > System Settings > Automation Settings, and the panel module turns each event into a line action.
  • WHMCS advances the Next Due Date from its previous value, not from the payment date, so decide how your panel expiry should follow it.
  • Failed panel actions land in Utilities > Module Queue, and WHMCS does not retry them on its own.
  • WHMCS sends customer notices by email only. Telegram and WhatsApp need a module, and Meta bills WhatsApp per message.
  • Automation handles billing and line provisioning only. You still need distribution rights for every channel you sell.

What should you automate after an IPTV store goes live?

An IPTV store usually launches with ordering and line creation working while recurring work is still manual. These jobs are worth automating next:

JobWhat handles itWhere you set it
Renewal invoices and remindersWHMCS daily automationAutomation Settings, Billing Settings
Suspend and restore linesCron plus the panel module's suspend and unsuspend functionsAutomation Settings, Automatic Module Functions
Panel expiry after paymentThe module's Renew functionPanel module settings
Reseller creditWHMCS credit system or credit-pack productsGeneral Settings, Credit tab
Trial expiryAuto Terminate/Fixed Term or a trial moduleProduct Pricing tab
NotificationsEmail templates, plus a messaging module for Telegram or WhatsAppEmail Templates, module settings
CancellationsCancellation requests and the module's terminate functionAutomation Settings, Miscellaneous

How should you time IPTV renewal invoices in WHMCS?

IPTV renewal invoices in WHMCS are created by the daily automation run, which happens at the hour set in Time of Day (9:00am server time by default). The Invoice Generation setting defaults to 14 days before the due date, which is long for a monthly streaming plan. Its Advanced Settings take a separate lead time per billing cycle, such as 5 to 7 days for monthly plans and 14 or more for annual ones, since larger payments take longer to arrange.

Reminders sit in the same section. Payment Reminder Emails and Invoice Unpaid Reminder control the reminder before the due date, and Overdue Reminder accepts up to three emails after it, with 0 skipping that email. If customers keep a balance, turn on Automatic Credit Use on the Credit tab of General Settings so new invoices are paid from credit as soon as they are generated.

When should WHMCS suspend and unsuspend IPTV lines?

IPTV line suspension in WHMCS is controlled by four settings under Automatic Module Functions in the Automation Settings: Enable Suspension, Suspend Days, Enable Unsuspension and Enable Termination with Termination Days. When the cron finds a service overdue past Suspend Days, WHMCS calls the module's SuspendAccount function and the line is disabled on the panel. Paying the overdue invoice calls UnsuspendAccount. WHMCS documents one exception: automatic unsuspension does not apply to services an admin suspended manually with a custom reason, so use a custom reason only when you want the line to stay off after payment.

Streaming customers notice a dead line within hours, so short suspension windows suit IPTV. A sample timeline for a monthly plan:

DayEventSetting
7 days before dueRenewal invoice createdInvoice Generation (Monthly)
2 days before dueUnpaid invoice reminderInvoice Unpaid Reminder
1 day overdueFirst overdue reminderOverdue Reminder
2 days overdueLine suspended on the panelSuspend Days = 2
Payment receivedLine restoredEnable Unsuspension
21 days overdueLine removed from the panelTermination Days = 21

Check Enable Auto Cancellation before you settle the timeline. It cancels unpaid invoices once they pass its Days Overdue value. Set it to Termination Days or later, so a suspended customer still has an invoice to pay that brings the line back.

How do you keep panel expiry dates in sync with WHMCS?

Panel expiry drift is the most common IPTV automation complaint, and it starts with how WHMCS counts renewals. According to the WHMCS billing logic documentation, paying a renewal invoice moves the Next Due Date forward one billing cycle from its previous value, regardless of the payment date. A customer who pays five days late keeps the same renewal day and loses those five days.

The panel side depends on your module. According to the provisioning module reference, WHMCS calls the module's Renew function each time a renewal invoice is paid, and the module then either sets the panel expiry to match the new Next Due Date or adds a fixed number of days to the panel's current expiry. The two give different results after a late payment, so confirm which one your module uses and state the rule in your terms. To keep the two systems aligned:

  1. Treat WHMCS as the source of truth. Extend or shorten lines through WHMCS, not directly on the panel, or the next renewal will overwrite the change.
  2. Once a week, compare a sample of panel expiry dates against WHMCS due dates for the same lines.
  3. Check Utilities > Module Queue daily. The Module Queue lists failed module actions, such as a renewal the panel rejected, and WHMCS does not retry them until you click Retry.
  4. If you need a fixed rule, such as expiry equals due date plus one grace day, have a developer add it with the PreModuleRenew hook or a DailyCronJob hook that checks the dates and logs differences.

Among WHMCSPilot's panel modules, the NXT module lists real-time account status sync and the Xtream UI module lists real-time status updates. The panel comparison covers how the four panels differ.

How do you automate IPTV reseller credits in WHMCS?

IPTV resellers usually buy credits and spend them to create or extend lines. WHMCS offers two routes. The built-in credit system on the Credit tab of General Settings lets customers add funds that pay future invoices, with Minimum Deposit, Maximum Deposit and Maximum Balance limits and a Require Active Order option that WHMCS recommends keeping on to limit chargebacks. The other route is a credit-pack product, where the panel module adds panel credits when the pack is paid.

Panel credit handling depends on the module. WHMCSPilot's Xtream UI module lists credit system integration and reseller account management, and the NXT module lists credit-based or subscription billing. If most of your lines sell through resellers and sub-resellers, compare WHMCS with a portal built for that model in WHMCS vs a standalone IPTV billing portal.

How do you make IPTV trials expire on their own?

An IPTV trial in WHMCS expires through the Auto Terminate/Fixed Term field on the product's Pricing tab: WHMCS terminates the service after the number of days you enter, and the module removes the line. Pick a termination email that carries an upgrade offer. The WHMCS Trial Module adds auto-conversion to a paid plan or auto-suspension at trial end, reminders before the end, and one trial per IP, email or payment method.

How do you send IPTV notices by email, Telegram or WhatsApp?

Customer notices in WHMCS are email templates by default, edited at Configuration > System Settings > Email Templates. Rewrite the invoice, reminder, overdue and suspension templates for streaming, with the renewal link and what happens to the line on each date. If renewal emails are not arriving, fix delivery first with the WHMCS email troubleshooting guide. The Notifications page under System Settings sends staff alerts, such as Slack messages, not customer notices.

ChannelWhat it needsCost to send
EmailWorking SMTP and authenticated sending domainYour mail provider's rates
TelegramA bot from BotFather, a messaging module, and each customer linking their accountThe Bot API is free; broadcasts are limited to about 30 messages per second unless you pay for higher limits
WhatsAppA Meta Business account, the WhatsApp Cloud API, approved templates and customer opt-inBilled per delivered template message, by category and country

For WhatsApp, Meta switched to per-message pricing on July 1, 2025, and its pricing page lists further changes effective October 1, 2026, so check current rates for your customers' countries before you budget. WHMCSPilot's Telegram Bot lists overdue and payment notices, inline payment buttons and account linking by one-time code; the WhatsApp Cloud Module lists invoice, payment and suspension messages with opt-in by phone verification. To run several channels from one set of rules, the Multi-Channel Notifications Module lists per-event channel mixes, quiet hours and failover from one channel to email.

How should WHMCS handle IPTV cancellations?

IPTV cancellations in WHMCS start when a customer clicks Request Cancellation on the product details page and chooses an immediate or end of billing cycle termination. The Show Cancellation Link option on the Other tab of General Settings controls whether that link appears. With Cancellation Requests enabled under Automation Settings, WHMCS runs the terminate command and sets the service to Cancelled on schedule; with it off, staff approve each request at Clients > Cancellation Requests. WHMCS also cancels unpaid invoices that contain only the cancelled service, so the customer is not chased for a plan they ended.

For IPTV, end of billing cycle is the fairer default, since the customer keeps the time they paid for. Leave the automation off at first if you want to read reasons and contact customers before lines are removed.

How do you check that IPTV automation is still running?

IPTV automation fails quietly, so build a short routine:

  1. Confirm the system cron runs every 5 minutes, for example */5 * * * * php -q /path/to/whmcs/crons/cron.php. If the daily automation email stops, follow the WHMCS cron troubleshooting guide.
  2. Scan the daily cron report for unusual invoice or suspension counts.
  3. Clear or retry every item in Utilities > Module Queue.
  4. Once a month, run one test service through renewal, suspension and unsuspension on a real panel account.

Frequently asked questions

Why did my IPTV line stay suspended after the customer paid?

The usual causes are Enable Unsuspension being off, a manual suspension with a custom reason, or a failed unsuspend call. Check Utilities > Module Queue and click Retry if the panel rejected the action.

Does paying late change the IPTV renewal date in WHMCS?

No. WHMCS advances the Next Due Date one cycle from its previous value whatever the payment date, so late payers keep their original renewal day. Whether the panel expiry follows that date depends on how your module's Renew function works.

How many days should WHMCS wait before suspending an IPTV line?

A short window of 1 to 3 Suspend Days suits streaming plans, with Termination Days of 14 to 30 so late payers can come back. State the numbers in your terms.

Can WHMCS send renewal reminders on WhatsApp or Telegram without a module?

No. WHMCS sends customer reminders by email, and its built-in Notifications feature is for staff alerts. Telegram or WhatsApp reminders need a messaging module, plus Meta template approval and opt-in for WhatsApp.

Do IPTV trials in WHMCS end automatically?

Yes, if the product has an Auto Terminate/Fixed Term value or a trial module controls it. WHMCS terminates the service when the trial period ends, and the panel module removes the line.

If you want this lifecycle set up and tested on your own panel, WHMCSPilot's IPTV provisioning service covers module installation, package mapping and a full renewal and suspension test.