Toplink DCIM for WHMCS

Before you connect

Check	How
DCIM has a user group	Users → User groups in the admin panel is not empty
DCIM has plans, and servers for sale are bound to one	The server’s assignment details show a plan
DCIM has a data center and available OS images	Required for provisioning and installation
You know WHMCS’s PHP version	The module is packaged per PHP version
ionCube Loader is installed	Required to load the module
WHMCS can reach DCIM	DNS, firewall and certificates are all in place

Setup steps

1. In DCIM: create a user group and plans and bind servers, then generate a key and secret under System API, optionally allowing only the WHMCS server’s outbound IP;
2. Install the module: upload the package for your PHP version;
3. Add a server: choose the “Toplink DCIM” module, enter the key as username and the secret as password, and tick SSL if DCIM uses https;
4. Custom settings: set the username prefix, hostname format and more;
5. Create products: choose the node, data center and plan, and enable automatic provisioning.

Common custom settings

• Username prefix: DCIM accounts are the prefix plus the WHMCS user ID, which must differ when several WHMCS sites share one DCIM;
• Hostname format: if a customer enters an invalid hostname, one is generated from placeholders such as {label}-{ipv4};
• Reseller mode: connect through the reseller API;
• Force English: keep the interface in English for international customers.

Automated lifecycle

• Order paid: server allocated, OS installed, hostname and IPs filled back;
• Overdue: server shut down and disconnected, then restored on renewal;
• Terminated: server unbound and IPs released.

For detailed field descriptions, see “Toplink DCIM integration with WHMCS” in the product documentation.