The ComputeStacks integration for WHMCS provides an easy onboarding experience for your customers. It offers a customized ClientArea integration, along with seamless onboarding.
- Each service in WHMCS corresponds to a single ComputeStacks account
- ClientArea output for quick overview
- Easy SingleSignOn buttons in both ClientArea and Admin
- Support for charging an initial deposit on registration
- Import CS accounts into WHMCS using the Server Sync Tool
This plugin will not delete any services in ComputeStacks. When a WHMCS service is terminated, this plugin suspends the account in ComputeStacks, which stops all running services. You will then need to manually delete the user. If you wish to have WHMCS automatically delete the users in ComputeStacks, please contact your CS support team.
Note: We require WHMCS v8+
For WHMCS versions before v8, please see v2.0.0.
Upload the plugin to your WHMCS server and move the whmcs/modules/servers/computestacks directory to the corresponding directory within your WHMCS installation.
Create a new server and supply your ComputeStacks installation details.
Note: You will need to generate API Credentials using an admin user in ComputeStacks. The API Key in ComputeStacks corresponds to the username field in WHMCS, and the API Secret is the password.
Our integration is designed to work in conjunction with our User Group functionality within ComputeStacks. This is useful if you decide to offer different tiers of service.
To create your ComputeStacks product, create a new product group and product with the settings:
- Pricing:
- With Deposit: Choose OneTime fee and set your deposit amount
- Without Deposit: Choose Free
- Module: ComputeStacks
- User Group: Your choice
- Apply Credit: If you added a one-time fee, you can optionally convert that to an account credit.
- Note: This will take place at the moment the order is paid.
- Module Setup:
- With Account Credits, we recommend either:
- Automatically setup the product as soon as the first payment is received (preferred for best user experience)
- Automatically setup the product when you manually accept a pending order
- Without Account Credits, we recommend either:
- Automatically setup the product as soon as an order is placed (preferred for best user experience)
- Automatically setup the product when you manually accept a pending order
- With Account Credits, we recommend either:
Before we proceed, you will need to first generate API credentials for ComputeStacks. Here are the roles that we need assigned:
Billing -> AddBillableItemClient -> GetClientsClient -> GetClientsDetailsClient -> GetClientsProductsProducts -> GetProductsProducts -> UpdateClientProductServers -> GetHealthStatus
WHMCS Access Control: Please see the documentation. You can either allow the IP Address of ComputeStacks, or configure an Access Key.
In ComputeStacks, navigate to the Administrator -> Advanced Settings -> Billing.
- Edit
BILLING_MODULEand set the value toWhmcsand click save. Once you do, additional settings will become available. - Set both
WHMCS_API_SECRETandWHMCS_API_KEY - If you set an API Access Key in WHMCS, then you can enter that under
WHMCS_ACCESS_KEY.
With WHMCS enabled, ComputeStacks will by default disable the registration form to ensure all new users come through WHMCS. Administrators can manually create users from within the admin.
If you wish to keep the registration form on, you can manually enable that under Settings -> Advanced Settings -> General and setting SIGNUP_FORM to t. Keep in mind that users will be able to register and will not be charged for their usage unless you manually set their external_id to the ID of their WHMCS service.
The final step is to set your prices under Settings -> Billing Plans.