When Virtualizor WHMCS provisioning fails, the order is paid but the VPS is not created, and the customer is waiting. The WHMCS module log nearly always names the cause, which is usually credentials, mapping or a lack of free resources.
Before you start
- WHMCS admin access and Virtualizor admin access.
- The service ID of the failed order.
Read the module log
- Open WHMCS → Configuration → System Logs → Module Log (older versions: Utilities → Logs → Module Log) and enable logging.
- On the service page, run Module Commands → Create again.
- Find the Virtualizor entry and read the response text.
Common Virtualizor WHMCS errors
| Symptom in log | Cause | Fix |
|---|---|---|
| Authentication / API failed | Wrong API key or pass, or WHMCS IP not allowed | Recheck credentials and the allowed IP list (admin API keys) |
| Could not connect | Port 4085 blocked, wrong hostname | Open the port to the WHMCS IP and test with curl |
| Plan not found | Product points to a deleted or renamed plan | Reselect the plan in the product's Module Settings |
| No IP available | The IP pool for the server is empty | Add IPs to the pool (IP pools and templates) |
| No server with enough resources | Node or server group full | Add capacity or change the server group |
| OS template not found | Configurable option value points to a removed template | Update option values to existing template IDs |
Tip: Check Virtualizor before retrying. If the create actually succeeded after a timeout, a retry makes a duplicate VPS.
Check module settings
- The product's Module Settings tab uses the right server group and plan, and the virtualisation type (KVM, OpenVZ and so on) matches the node.
- Configurable options and custom fields use the names the module expects; re-run the module's option creation if they were edited by hand.
- The Virtualizor WHMCS module version matches your Virtualizor version.
Retry and finish
- Fix the cause and run Create again.
- Confirm the VPS exists in Virtualizor under the client's user.
- Resend the welcome email if needed.
Frequently asked questions
Why does create not run automatically?
Check the product's automatic setup option and that the WHMCS cron runs regularly.
Can I link an existing VPS to a service?
Yes, by entering the VPS ID in the service's module fields, as described in the module documentation.
Where do customers manage the VPS?
From the WHMCS service page, which opens the Virtualizor panel through single sign-on.