Sell VPS automatically with the WHMCS Virtualizor module

With the Virtualizor module, WHMCS creates a VPS as soon as an order is paid, suspends it when invoices are overdue and lets clients start, stop, reinstall and open VNC from the WHMCS client area. This guide connects the two systems and builds a VPS product.

Before you start

• A working Virtualizor admin panel with plans, IP pools and OS templates. See create Virtualizor plans.
• WHMCS installed with a running cron.
• The Virtualizor WHMCS module. Current WHMCS versions ship with it; otherwise download it from Virtualizor and upload it to /modules/servers/virtualizor/.

Create an API key in Virtualizor

1. Log in to the Virtualizor admin panel (port 4085).
2. Go to Configuration → API Credentials (or API) and click Create API Key.
3. Copy the API Key and API Password.
4. Restrict the key to the WHMCS server's IP address if the option is available.

Add the server in WHMCS

1. Go to Configuration → System Settings → Servers → Add New Server.
2. Choose module Virtualizor.
3. Enter the Virtualizor host name or IP.
4. Enter the API key as Username and the API password as Password (field names vary by module version; follow the labels shown).
5. Tick Secure to use HTTPS on port 4085, click Test Connection and save.
6. Create a server group, for example VPS Germany, containing this server.

Create a VPS product

1. Go to Configuration → System Settings → Products/Services → Create a New Product.
2. Product type Server/VPS, module Virtualizor.
3. Set pricing on the Pricing tab.
4. On Module Settings, choose the server group, the Type (KVM) and the Virtualizor Plan. The plan's CPU, RAM, disk and bandwidth apply to the VPS.
5. Choose Automatically setup the product as soon as the first payment is received.

Let clients choose an OS and location

Create a configurable option group with an option named OS Template (or the name the module documentation specifies) whose sub-options match Virtualizor template names or IDs. Add a Server or location option the same way if you have several nodes. See configurable options and addons. Add a custom field for the hostname and root password if your module version requires it.

What clients see

On the service page in the WHMCS client area, clients get buttons for Start, Stop, Restart, VNC, Reinstall and statistics, plus a single sign-on link to the Virtualizor panel. This keeps them in your brand and reduces tickets.

Test the flow

1. Place a test order and mark the invoice paid.
2. Check that the VPS appears in Virtualizor with the right plan and an IP.
3. Confirm the welcome email shows the IP and login details.
4. Test suspend and unsuspend from the WHMCS service page.

Troubleshooting

• Connection failed: wrong API credentials, port 4085 blocked, or the key is limited to a different IP.
• "No free IP": the IP pool for that server is empty.
• Plan not found: the plan name in WHMCS differs from Virtualizor.
• Always check Utilities → Logs → Module Log for the API response.

Next steps

• Set suspension rules.
• The Virtualizor end-user panel.
• Customise the VPS welcome email.