Revision as of 00:47, 24 August 2010

aWHMCS is the Official Android App for WHMCS.

The price of aWHMCS is a $34.95 one-off charge which allows as many instances of aWHMCS to be used by as many different staff on as many different phones as you wish (the same licensing scheme as with all our mobile editions).

Please visit http://www.whmcs.com/androidapp.php 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 > Check for Updates inside your WHMCS installation to have it take effect.

3. Now, you're ready to download the aWHMCS App - you can download this directly from us @ http://www.whmcs.com/members/dl.php?type=d&id=55 or from the Android App Store by searching for "aWHMCS Official WHMCS App" - http://www.androidpit.com/en/android/market/apps/app/com.whmcs.awhmcs/aWHMCS-Official-WHMCS-App

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 domain should be the URL to your main site url , for example Domain "http://demo.whmcs.com/" Then the PATH would be the directory for the client area so if in the root "/" or "http://www.yourdomain.com/whmcs/" The domain would be http://www.yourdomain.com/ Then the PATH would be the directory for the client area "/whmcs/" and the admin username & password the same as you use to login to the main admin area.

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.