WHMCS
TREX OTT WHMCS Module for Automated Provisioning
Create, suspend, restore, terminate and renew customer lines straight from WHMCS invoices. Requirements, installation, and what to check when an action fails.
If you sell through WHMCS, the module removes the manual step between an invoice being paid and a customer’s line existing. It also removes the manual step at the other end — suspending a line when an invoice goes overdue, and restoring it when the money arrives.
What it does
| WHMCS action | What the module does |
|---|---|
| Create | Provision a line automatically when an order is paid, or manually from the client profile. |
| Suspend | Suspend the line when an invoice goes overdue, on WHMCS’s own schedule. |
| Unsuspend | Restore the line as soon as payment clears. |
| Terminate | End the line when the service is cancelled or terminated in WHMCS. |
| Renew | Extend the line automatically when a renewal invoice is paid. |
Each action can also be triggered by hand from the client’s service page in WHMCS, which is what you want when you are fixing something rather than running the normal flow.
Requirements
| You need | Notes |
|---|---|
| A working WHMCS installation | The module is a WHMCS provisioning module and installs the way any other one does. |
| A TREX OTT reseller account with API access | Issued to you with your account. Never published. |
| Outbound HTTPS from your WHMCS host | WHMCS calls the panel API; a firewall that blocks outbound requests will make every action fail silently. |
| A product in WHMCS per package you sell | Each WHMCS product maps to a package and duration on the panel side. |
Installing it
- Download the module
The module is distributed from inside the reseller panel — there is a Download WHMCS Plugin action on the dashboard. It is not offered as a public download, because it is tied to accounts that have API access.
- Upload it
Place the module directory under
modules/servers/in your WHMCS installation. - Add the server
System Settings → Products/Services → Servers. Create a server entry using the module and enter the API credentials from your panel.
- Test the connection
WHMCS will confirm it can reach the panel. If it cannot, check outbound HTTPS before anything else — that is the usual cause.
- Map your products
For each WHMCS product, set the module fields so the product creates the right package and duration. Get one product working end to end before you configure the rest.
- Place a test order
Order through the client area, pay the invoice, and confirm the line appears in the panel. Then cancel it and confirm the line terminates.
When something goes wrong
| Symptom | Usual cause | What to check |
|---|---|---|
| Every action fails immediately | API credentials wrong, or the server entry points at the wrong host | Re-enter the credentials from the panel; do not retype them |
| Actions time out | Outbound HTTPS blocked on the WHMCS host | Test a plain HTTPS request from that host to the panel |
| Order pays but no line is created | The product is not mapped to the module, or auto-setup is off | Product settings → Module Settings, and the auto-setup option on the product |
| Lines suspend when they should not | WHMCS overdue schedule, not the module | WHMCS automation settings — the module only acts on what WHMCS tells it |
| A line exists twice | A manual creation on top of an automatic one | Terminate the orphan in the panel, then re-run the module action |
Never paste API credentials into a support message, a forum, or a screenshot. If you think a key has been exposed, ask us to rotate it — that is quick and costs nothing. Panel security covers the rest.
Questions
Which WHMCS versions are supported?
Ask sales for the version the current build is tested against rather than relying on a number on a web page that may be months old. If you are on an unusual version, say so before you buy.
Does it work with more than one panel?
Yes — add a server entry per panel and point the relevant products at it.
Does it handle upgrades and downgrades?
The module implements create, suspend, unsuspend, terminate and renew. Anything beyond those five is a manual change in the panel; do not assume otherwise.
Is there an extra charge for the module?
It is distributed through the panel to accounts with API access. Confirm commercial terms with sales rather than assuming.
Can I use the API without WHMCS?
Yes. The module is one consumer of the API; ask sales for the current specification.