Billing system bridge
Connect WHMCS or IDCSmart: orders, renewals, suspensions and plan changes open accounts and plans automatically, with passwordless login and usage.
What it solves
An IDC's customers order and pay in WHMCS or IDCSmart, but CDN accounts have to be opened by hand in another console. The billing bridge connects the two: when a customer orders, renews, suspends, upgrades or downgrades in the billing system, the CDN side opens the account and plan, suspends, renews or changes the plan automatically. Customers click a button in the billing system to enter the CDN console without a password, and the billing system can show traffic usage.
Two ways to connect, usable together:
| Mode | Where the key is created | Who it manages |
|---|---|---|
| Reseller on the platform | User console, Reseller → Billing integration | Only that reseller's customers; provisioning is charged from prepaid balance at wholesale price |
| Your own control plane | Admin console, System → Billing integration | Direct customers on that control plane |
Turning it on
The billing bridge is an official, free plugin of the commercial edition, active once fetched from the plugin store. The community edition does not include it.
- On the Billing integration page, download the PHP module (WHMCS, IDCSmart classic, IDCSmart V10). For WHMCS, unpack it into
modules/servers/under the WHMCS root. - Click New key, enter the billing server's outbound IP and your second-factor code, and save the key_id and secret that appear.
- In WHMCS, go to System Settings → Servers → Add, choose the CDNCA module, enter the API address, key_id and secret, and click Test connection.
Main settings
| Setting | What it does |
|---|---|
| IP allowlist | The billing server's outbound IPs, 1 to 32 entries, no /0 |
| Expiry | Optional; empty means never |
| Rotate | The old secret stops working at once; update it in the billing system |
| Revoke | Permanent; the billing system loses access immediately, existing customers and subscriptions stay |
| Integration log | One line per call, kept 90 days |
Typical uses
- An IDC sells CDN as a product in WHMCS: accounts open on payment and suspend when not renewed.
- A reseller on the platform who also runs their own control plane: configure two "servers" in WHMCS, one per key.
Limits and notes
- The secret is shown once at creation; if lost, rotate it.
- Once the module is revoked every bridge call is refused; customers and subscriptions already opened stay.
- The reseller mode needs the platform administrator to enable the plugin and the user to be an active reseller.