SolusIO

From WHMCS Documentation

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

Supporting 3 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 SolusIO 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 SolusIO 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 SolusIO control panel.

For more information, please refer to our SolusIO FAQ

Installation

The WHMCS SolusIO integration is compatible with WHMCS 7.8.0 and later.

  1. Download the latest version of the integration via the WHMCS Marketplace: https://marketplace.whmcs.com/product/5619-solusio-official-integration
  2. Extract the zip file
  3. Upload the 'solusio' directory to the '/modules/addons' folder of your WHMCS installation.

First Use

  1. Log in to the WHMCS Admin Area.
  2. Navigate to Configuration () > System Settings > Addon Modules or, prior to WHMCS 8.0, Setup > Addon Modules.
  3. Locate the SolusIO module in the list.
  4. Click the Activate button.
  5. Upon success, click the Configure button.
  6. Under Access Control, select the user group to which your admin user is assigned.
  7. Click Save Changes.
  8. After the page reloads, navigate to Addons > SolusIO.

You will then be guided through the process of connecting to your SolusIO instance.

Accessing the SolusIO Integration

You can access the SolusIO 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 SolusIO

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

SolusIOConnect.png

Enter the URL to your SolusIO 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 SolusIO user area.

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

Upon success, you will be redirected to management screen.

Setup & Use

Post-Pay

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

SolusIOPostPaySetup.png

Landing Page

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

SolusIOPostPayLandingPage.png

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/solusio/templates/post-pay/landing-page.tpl into the active WHMCS client area template directory under the path /templates/{active_template}/modules/addons/solusio/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 NameDescription
New User Limit GroupSelect 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 SolusIO control panel)
Post-Pay General Settings

The general settings allow you to control general settings.

Setting NameDescription
Post-Pay Terms & ConditionsAn optional URL to Terms & Conditions for the Post-Pay Billing service for SolusIO. 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 NameDescription
Invoicing Grace PeriodThe 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 NameDescription
Lock Overdue UsersThe number of days you want to allow before locking a user account in SolusIO. This is the number of days from the due date.
Suspend Overdue UsersThe number of days you want to allow before suspending a user account in SolusIO. This is the number of days from the due date.

For more information regarding locking and suspension restrictions, please refer to the SolusIO 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.

SolusIO Setup

The following articles describe configuration and setup within the SolusIO system itself.

WHMCS Billing Integration

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

The billing integration allows SolusIO 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 SolusIO module and a SolusIO 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 SolusIO target instance using the API Connection panel located within the Settings tab of the SolusIO WHMCS integration module.