Skip to content

WHMCS Billing integration

Our SolusVM 2 Integration is the official integration between WHMCS and the SolusVM 2 Virtual Infrastructure Management Platform.

This supports three methods of billing integration:

  • Self-Service VM Provisioning with Post-Pay Billing - Available now - Allow customers to register for access to VM provisioning, manage virtual machines and provision on-demand via the SolusVM 2 control panel, and have billing performed at set intervals by WHMCS in a post-pay (pay after use) model.
  • Self-Service VM Provisioning with Pre-Pay Credits - Coming Soon! - Allow customers to register for access to VM provisioning, deposit funds in advance, and manage virtual machines and provision on-demand via the SolusVM 2 control panel. Usage charges are assessed against the customers available balance in real-time.
  • Retail VM Selling - Coming Soon! - Sell pre-configured VPS plans through your WHMCS online store. Offer traditional style VPS and virtual machines with a fixed monthly price, prepaid up front and billed on a regular fixed billing cycle. Customers will not need to use the SolusVM 2 control panel.

For more information, see WHMCS Post-Pay Billing page.

Addon Name Latest Release Current Version Compatible With Included in WHMCS
SolusVM 2 N/A N/A WHMCS 7.8 and later No

Activating SolusVM 2

You will need to download and upload the module before you can activate the addon through the Admin Area.

To do this:

  1. Download the latest version of the integration via the WHMCS Marketplace.
  2. Extract the zip file.
  3. Upload the 'solusvm2' directory to the '/modules/addons' folder of your WHMCS installation.
  4. Go to Configuration > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules.
  5. Click Activate for SolusVM 2.
  6. Click Configure.
  7. Select the admin role groups who will have access to this addon.
  8. Click Save Changes.

Using the Addon

You can access the SolusVM 2 module within WHMCS at any time by navigating to Configuration > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules within the WHMCS admin area.

Connecting to SolusVM 2

Upon accessing the SolusVM 2 module for the first time you will see a screen as follows.

Enter the URL to your SolusVM 2 installation. This should be the url you use to access the web interface.

Enter your API Key. This can be retrieved by navigating to Account > API Tokens > Generate API Token when logged into the SolusVM 2 user area.

Click Test Connection to verify a connection can be established with the SolusVM 2 system

Upon success, you will be redirected to management screen.

Setup

Post-Pay

Upon accessing the SolusVM 2 module post connecting to SolusVM 2, you will be presented with the following screen which allows you to set settings related to Post-Pay billing.

Landing Page

The WHMCS SolusVM 2 Post-Pay functionality comes with a ready made landing page designed to make it quick and easy to get up and running with offering SolusVM 2 services. The link is provided here for convenience. This page can only be accessed when Post-Pay billing is enabled.

Menu items are automatically added to the WHMCS client area when enabled. For logged out users, it can be accessed via a Cloud Hosting option in the main menu. For logged in users, it can be accessed via a Cloud Hosting menu option under the Website & Security dropdown menu.

Customising the Landing Page

The landing page is controlled by templates and can be customized. To make changes, we recommend copying the file /modules/addons/solusvm2/templates/post-pay/landing-page.tpl into the active WHMCS client area template directory under the path /templates/{active_template}/modules/addons/solusvm2/post-pay/landing-page.tpl. All paths are relative to the WHMCS root installation directory. From there, you can make changes to the template within your WHMCS client area template directory and these customisations will be preserved during module updates.

Configuration

Post-Pay Limit Group

The limit group settings allow you to control settings related to limits imposed on new Post-Pay enabled users.

Setting Name Description
New User Limit Group Select the limit group you wish to be applied by default to all new Post-Pay users. (* Limit groups must be created and defined within the SolusVM 2 control panel)

Post-Pay General Settings

The general settings allow you to control general settings.

Setting Name Description
Post-Pay Terms & Conditions An optional URL to Terms & Conditions for the Post-Pay Billing service for SolusVM 2. Use this to provide additional terms relating to the invoicing and payment of Post-Pay service usage.

Post-Pay Invoicing

The invoicing settings allow you to control settings related to invoices generated for Post-Pay usage.

Setting Name Description
Invoicing Grace Period The number of days you want to allow after generation before an invoice is considered overdue.

Post-Pay Suspension

The suspension settings allow you to control settings related to service restrictions for non-payment of Post-Pay usage.

Setting Name Description
Lock Overdue Users The number of days you want to allow before locking a user account in SolusVM 2. This is the number of days from the due date.
Suspend Overdue Users The number of days you want to allow before suspending a user account in SolusVM 2. This is the number of days from the due date.

For more information regarding locking and suspension restrictions, please refer to the SolusVM 2 documentation.

Settings

The settings tab allows you to modify connection and pricing settings.

Post-Pay Token Pricing

Token Pricing must be set for each active currency within WHMCS.

Token Pricing can be set up to 4 decimal places.

The prices entered should be the monetary cost in each given current for 1 unit of token usage.

API Connection

The API Connection panel can be used to modify and update the Installation URL and API Key at any time.

To make a change, enter both the Installation URL and an API Key and click the Test Connection button to validate the inputs.

If a connection is successful, the URL and API Key used by WHMCS will be updated.

WHMCS Billing Integration

Within the SolusVM 2 product, it is possible to configure Billing Integration Settings.

The billing integration allows SolusVM 2 to retrieve token pricing information as well as perform single sign-on to the WHMCS billing portal.

WHMCS will auto-configure the WHMCS Billing Integration values for you every time a successful connection is established between the WHMCS SolusVM 2 module and a SolusVM 2 target instance. It is not possible to generate and set these values manually.

Should there be a need to re-configure or re-setup the connection at any time, you will need to re-establish the API Connection with the SolusVM 2 target instance using the API Connection panel located within the Settings tab of the SolusVM 2 WHMCS integration module.

Back to top