Troubleshooting
Connection test fails
- Hostname must be a URL (
https://host:port) - cPanel: WHM token in
api_token, userrootor a reseller with API access - Plesk: admin user/password; REST
/api/v2and XML agent both used - DirectAdmin: use an admin account; package APIs are empty for user-level logins
- CWP:
api_tokenrequired; hostname port 2304; key format JSON; allow the Webfox server IP orALLin CWP API Manager
Product getPackage empty
The package does not exist on that panel, or the server row points at the wrong host. Create WFX-SH- / WFX-RH- on the panel, then reload the product form.
Payment OK, hosting still Pending
- Open /admin/automation/errors
- Common cPanel error: reserved username (names starting with
testand similar). Set a new username on the hosting and run create - Package name mismatch (spaces, case)
- Plesk: customer may already exist (
User account already exists) while the domain was not created — create the domain against that client, then set hosting Active - CWP: HTTP to port 2304 or XML key format — use
https://…:2304and JSON key
Plesk shared create
Plesk shared hosting: REST create client then domain. Reseller uses XML reseller/add with plan-name. If createClient returns nothing, inspect /api/v2/clients for an existing login.
DirectAdmin usernames
Max length 8. Observer truncates; collisions get the hosting id suffix.
Wallet pay disabled
Invoice wallet option requires deposit_module on general settings. Insufficient balance is a client-side error, not a module error.
SSL checkout errors
CSR and validation method are required on SSL cart lines.
Docs URL vs Knowledge Base
- Manuals: /docs
- CMS: /knowledgeBase
If /docs shows a directory listing or a CMS page, the rewrite in /docs/.htaccess or the Laravel route before /{slug} is missing.