Revision as of 15:40, 2 January 2018

aWHMCS is the Official Android App for WHMCS.

Available for either $2.99 monthly or $29.99 per year, once a license is purchased it allows all your staff to use aWHMCS in conjunction with your WHMCS installation on any of their Android devices (the same licensing scheme as with all our mobile editions).

Please visit www.awhmcs.com for more information.

Setup Instructions

1. To begin with (if you haven't already done so), you will need to order the Android App addon from our client area. It's available as an addon to a license and can be ordered by logging into our client area @ www.whmcs.com/members/clientarea.php and selecting "View Available Addons" from the navigation bar.

2. Once you've ordered and paid, the addon will be instantly activated and you'll just need to perform a local key update by going to Help > License Information inside your WHMCS installation and then clicking on the Force License Update button to have it take effect.

3. Now, you're ready to download the aWHMCS App - you can download this from the Google Play Store by searching for "aWHMCS" - https://play.google.com/store/apps/details?id=com.whmcs.awhmcs2

4. Now locate and open the app on your Android device

5. The first time you start the app, you'll be taken straight to the configuration screen for you to input your WHMCS connection details. These consist of your WHMCS URL, admin username & password and an access key.

6. The URL should be the URL to your WHMCS directory without a trailing slash. For example if installed @ "http://demo.whmcs.com/" then the URL setting would be "http://demo.whmcs.com" and the admin username & password the same as you use to login to the main admin area.

If installed @ "http://www.yourdomain.com/whmcs/" then the URL setting would be "http://www.yourdomain.com/whmcs" and the admin username & password the same as you use to login to the main admin area.

Please note that your Admin account role needs to have API Access permission.

7. The access key is slightly more complicated. For this, you need to open up the configuration.php file for your WHMCS installation and add a line to it such as the one below:

$api_access_key = "abc123";

The abc123 in the above should be replaced with a random series of letters and numbers, you can think of it like a second password, and that same value is what you'll need to enter into the Access Key field on your phone

8. Then simply click Save and the connection will be tested. If any of the details were entered incorrectly you'll receive an Access Denied (username/password failure) or Invalid Access Key error message and be returned to re-enter the details.

9. If all was correct, you'll be taken to the home screen and can begin using the app.

Security PIN

The app offers a security Personal Identification Number (PIN) feature. When a PIN has been configured you will be prompted to enter it when starting or returning to the aWHMCS app, so that even if your device is lost, stolen or being used by friends/family, they cannot access your business data. To configure the PIN:

Edit Security PIN

• From the Home screen, tap the options icon,
• Tap Settings
• Tap PIN code
• Follow on on screen instructions to choose your 4 digit PIN and confirm it.

To change or remove the security PIN:

• From the Home screen, tap the options icon,
• Tap Settings
• Tap PIN code
• Enter your current PIN
• Enter the new PIN and press OK to confirm, or tap Clear and the PIN protection will be removed.

Using the App

Don't forget to press the menu button on your handset to access extra options, almost every screen has this ability. If your handset does not have an options button, an icon consisting of three dots will appear in the top corner instead.

Common Problems

The common error responses from the API can be found at API:Responses

Invalid IP

This error means the API Access Key has not been added successfully to the configuration.php file. Please refer to step 7 above. The $api_access_key line should go before the closing ?> tag.