Integrating WHMCS with your 20i Reseller Account
Setting up Web Host Manager Complete Solution (WHMCS) with your 20i reseller hosting account allows you to automate the provisioning of your 20i services to your own clients. Clients will be able to buy products from your site without the need for you to set them up these manually from within your 20i account.
Here's a handy video guide, or you can follow the steps below.
1.1 Getting Started
To setup WHMCS with 20i you'll firstly need to buy a licence. If you have an existing licence you can purchase 20i's discounted WHMCS licence and switch this over using the guide here: How do I change the license key WHMCS uses?
Once you've bought the WHMCS licence you'll need to install it to your webspace.
1.2 Installing WHMCS
At 20i we provide a one-click installation process for WHMCS. To use this head to https://my.20i.com/whmcs. You'll see the 'Install' button next to your active licence. Select this and you'll be prompted to select a package and a directory to install WHMCS.
Once you’ve installed WHMCS, login into your admin panel: www.Yourdomain.com/yourWHMCSdirectory/admin
Now that you’ve logged-in you'll need to obtain the combined API key. This can be found within your 20i Reseller account by going to “Reseller Management” > “Reseller Preferences” > “API”, or by going here: https://my.20i.com/reseller/api
Note: Please keep a note of the Combined API Key as this will be used later on.
1.3 Adding your 20i Products to WHMCS
1.3.1 Creating custom client fields
When your clients sign-up and purchase products from you, a StackCP User needs to be created to allow them access to manage their products. Their level of access can be controlled by you as the reseller. To enable StackCP User creation when your clients sign-up you'll just need to create a custom client field.
- Within your WHMCS admin, navigate to “Setup” > “Custom Client Fields”. Create the new field, You will need to check 'Admin Only' from the check boxes shown.
- You can name the first field anything you like, for example “StackCP User”.
- You can now proceed to creating product/services fields.
1.3.2 Connecting to the API
- Within your WHMCS admin, navigate to “Setup” > “Products/Services” > “Servers”
- You can name the server anything, for example “20i’s WHMCS module”.
- You will need to enter your default name servers this will be:
Note: If you have Virtual Nameservers (custom nameservers) you can enter these instead.
- Locate server details a little further down the page and select “20i”. You can leave the username blank and then enter in the combined API key as the password.
1.3.3 Creating product/services fields
- You'll now want to look at adding the products that you'll be selling from 20i via WHMCS. These will be the hosting package types that you have set up within your My20i account.
- Navigate to “Setup” > “Products/Services” > “Product/Services”, then select the 'Custom Fields' tab.
- The Field Name will need to be “packageId”. You will need to select this field to be 'Admin Only'.
- Once you've done this head to the 'Module Settings' tab - from here, select '20i' from the 'Module Name' drop down menu.
- From the 'Type Code' dropdown, select the package type for the product you're configuring.
- Select 'Save Changes'.
Note: For each product/service you configure you will need to add a new custom field.
You can now proceed to set up 20i as the domain registrar.
1.3.4 Setting up domain registrars
- Within your WHMCS admin, navigate to “Setup” > “Products/Services” > “Domain registrars”.
- You should see '20i' in the list of modules, please select 'Configure'.
- Enter your combined API key into 'Password' field. (You can leave your admin username blank)
- Select your admin user.
- Select your custom user field that you created. Our example was “StackCP User”.
You can now click 'Activate'.
1.3.5 What's next?
Now the 20i WHMCS module should now be linked with your account. If you already have services and StackCP users within 20i then you'll want to import those into your WHMCS set up.