Billing Linux cPanel Windows Control Panel Client Voip ms sql webadmin ms sql backup mysql webadmin Server Status

Main Menu

ASPnix Knowledgebase

  • What do error code(s) 81703 and 91577 mean? How do I fix these errors?

    No comments April 18th, 2017 302

    ERROR_1 => Code: 91577 Message: Merchant account does not support payment instrument.
    ERROR_2 => Code: 81703 Message: Credit card type is not accepted by this merchant account.

    Seeing an error similar to the ones shown above means that your WHMCS system is attempting to process a card type that is not accepted by your Braintree account. For example, a customer pays with an AMEX card, but your Braintree account only allows VISA and Discover.

    To fix this, you will need to contact Braintree to discuss adding other card types to your account. You should also only select the card types allowed by your Braintree account in your WHMCS installation’s “Invoice” tab under the “General Settings” option. The line item is titled “Accepted Credit Card Types”.

    1 Star2 Stars3 Stars4 Stars5 Stars (No Ratings Yet)
  • How do I use the fraud protection included with my Braintree merchant account?

    No comments June 25th, 2015 1582

    For more information on how the fraud protection through Braintree works and how to enable it within your account, please review their support article here –

    To enable fraud protection in our module, please follow the steps below…

    1. Activate Advanced Fraud Tools in your Braintree account – Guide Here
    2. From the WHMCS administrator, open, Setup => Payments => Payment Gateways
    3. Find your Braintree gateway settings
    4. Check / Enable “Enable Advanced Fraud”
    5. Press “Save Changes”
    6. From the WHMCS administrator, open, Setup => Addon Modules
    7. Activate the “Braintree Advanced Fraud Helper” addon module (No permissions need to be set or applied for this module)
    8. You are done!

    To test, submit a credit card payment, then check the WHMCS Gateway Log output, find the transaction for the payment you just completed, you should see a field called [riskData] with 2 fields below it called [id] and [decision].

    What if I do not know my credit card form DOM id?

    Open your client area template creditcard.tpl and viewcart.tpl file with your favorite HTML editor and find the credit card <form> and find the id=”….” the …. will be the DOM id of your form. If your form does not have an id=”….”, you will need to add one to it. If you are unsure how to do this, please contact your web developer. For example, you could add id=”cc-payment_form” then your DOM id name would be cc-payment_form.

    If you have any questions about this, please contact our WHMCS Module support department and we will be glad to assist you!

    As of Braintree Module release v1.1.2 the form ID is found automatically. If your checkout / credit card forms do not have an id set, you will need to contact your web developer to get this fixed. The <form … id=”…”> must be set in order for the Braintree data library to inject the required form data.

    ASPnix provides no warranty and is not responsible for any errors that occur from editing or altering your templates / WHMCS settings.

    1 Star2 Stars3 Stars4 Stars5 Stars (No Ratings Yet)
  • Are multiple currencies supported by the Braintree Payment Gateway module?

    No comments September 20th, 2014 1657

    Yes, our module fully supports multiple currencies through multiple Braintree merchant accounts. In order to use multiple currencies you will need to contact Braintree to get more information on having multiple merchant accounts. Each merchant would have a different id which you would supply in the payment gateway “Merchant Currencies” field. Please note that the “Merchant ID” field will still contain your primary merchant account id.


    Your Merchant Currencies field would look like the above example. Each currency and merchant id is on its own line in the format CURRENCY:MERCHANT_ID. Our module will automatically find the correct merchant ID to use based on the customer’s selected currency.

    Note that you will need a merchant id for each currency your WHMCS system supports.

    1 Star2 Stars3 Stars4 Stars5 Stars (7 votes, average: 5.00 out of 5)
  • Does my WHMCS installation have to be PCI complaint to use the Braintree Payment Gateway module?

    No comments September 20th, 2014 1702

    Yes. Per their (Braintree) requirements, you must be PCI compliant. If you are not PCI complaint will not be able to accept and store credit card payments. Our module uses direct server-to-server communications to send client credit card details to the Braintree services for processing. Our module is designed to work alongside WHMCS’ encrypted Credit/Debit card storage to enable automatic recurring billing / automatic invoice payments.

    Our module enables your WHMCS installation to accept Credit/Debit card information right on your site without having to be redirected to a 3rd party client or without the use of a 3rd party popup window etc. This enables a more seamless and professional appearance for your clients.

    1 Star2 Stars3 Stars4 Stars5 Stars (6 votes, average: 5.00 out of 5)
  • How do I install the Braintree Gateway for WHMCS?

    8 comments September 20th, 2014 1985

    Below are the steps required to install and activate the Braintree Payment Gateway module for WHMCS…

    1. Download the latest build of the Braintree module and our licensing system for your WHMCS version
    2. Extract and upload the files to your WHMCS web root / document root
      1. Make sure you also upload the ASPnix licensing system to your WHMCS root as well!
    3. Navigate to your WHMCS administrator area and select Setup => Payments => Payment Gateways
    4. Activate the Braintree gateway
    5. Input your Braintree merchant ID, public and private keys as well as your ASPnix product license
    6. Click “Save Changes”
    7. Under your Braintree “Processing Settings” find the “Custom Fields” section and click “Add New”
    8. You will need to add 2 custom fields; invoice_id and user_id per the screenshots below

    HIGHLY recommend that you test in a sandbox environment first, note that the API details for sandbox and production are different.

    1 Star2 Stars3 Stars4 Stars5 Stars (4 votes, average: 5.00 out of 5)
  • What are the requirements for the Braintree Payment Gateway module?

    No comments September 20th, 2014 1774

    The requirements are listed below. The module may work under different conditions, but has only been tested by our developers in these scenarios. This article assumes that your system, server and PHP installation meets the requirements of WHMCS itself. Their requirements can be found here

    System Requirements

    • Clear understanding of using WHMCS as well as uploading, installing and configuring addons and gateways
    • PHP 5.6 or higher
    • WHMCS 7.x (we do not support alpha, beta or release candidate builds)
    • OpenSSL (or any SSL library) w/ TLS 1.1+ support

    PHP Extension Requirements

    • cURL w/ TLS 1.1+ support
    • DOM
    • Hash
    • OpenSSL

    Braintree Requirements

    • A Braintree Merchant Account – If you do not have one, you may sign up here
    • Verify that your Braintree Merchant account accepts credit/debit cards
    • PCI Compliant – For more information, see their FAQ

    Requirements Test Script

    We offer a PHP script that will quickly and easily check your PHP and WHMCS installation for any missing requirements, the tool can be downloaded here –


    1 Star2 Stars3 Stars4 Stars5 Stars (3 votes, average: 5.00 out of 5)
  • What are the licensing terms for the Braintree Payment Gateway module?

    No comments September 20th, 2014 1638

    This product is licensed as a one-time purchase. No monthly or annual fees apply to this product to use the product, however there is an annual renewal fee for continued support and upgrades. The license is valid for use on one WHMCS installation only. If you move your WHMCS installation to a new IP address, change the path of the WHMCS installation or change the domain name that your WHMCS installation is running under your license will need to be re-issued so that it may activate under the new location.

    If you have any questions about the licensing of this product, please contact our sales team!

    1 Star2 Stars3 Stars4 Stars5 Stars (2 votes, average: 5.00 out of 5)
  • Braintree Payment Gateway Module changelog & release details

    2 comments September 20th, 2014 2006

    Version 1.2.5 - Released 07.31.2017

    Updated the Braintree core libraries to the latest build
    Added handling of unknown fraud tool risk decisions
    Notice for no risk decision on orders with no risk data (fraud record not enabled)
    Improved displaying of "Decline" fraud risk decisions
    Improved handling of both multiple currencies and an account id

    Version 1.2.4 - Released 07.10.2017

    Updated to work with the new ASPnix 2.0 licensing system
    Updated the Braintree core libraries to the latest build

    Version 1.2.3 - Released 05.21.2017

    Added new option for specifying the merchant account id used for the transaction

    Version 1.2.2 - Released 05.03.2017

    Support for multiple currencies has been resolved in this build, please see our KB for more information

    Version 1.2.1 - Released 04.18.2017

    Updated the Braintree core libraries to the latest build			
    Resolved an issue where 3D Secure was not loading when enabled

    Version 1.2.0 - Released 04.10.2017

    Updated the Braintree core libraries to the latest build

    Version 1.1.9 - Released 02.13.2017

    Error no longer occurs on orders paid by account credit when payment method is the braintree module and the braintree fraud addon is enabled

    Version 1.1.8 - Released 12.16.2016

    Resolved an issue where WHMCS was unable to activate / deactivate any Payment Gateway modules

    Version 1.1.7 - Released 12.12.2016

    Added support for 3D Secure
    Improved gateway logging of Gateway validation errors

    Version 1.1.5 - Released 12.01.2016

    Added check for missing required custom fields

    Version 1.1.4 - Released 11.11.2016

    Fixed a JavaScript error no longer occurs on certain browsers / WHMCS themes
    Added new Output notice when viewing a pending order that displays the fraud tools decision
    Improved the gateway log transaction output to include additional fields

    Version 1.1.2 - Released 11.10.2016

    The Advanced Fraud Tools addon now uses the JSv3 Braintree API
    The Advanced Fraud Tools addon no longer requires the form DOM id value specified
    The Advanced Fraud Tools addon now works correctly on the client area credit card form

    Version 1.1.1 - Released 09.13.2016

    Improved gateway logging details
    General improvements / code cleanup

    Version 1.0.5 - Released 07.10.2015

    Full support for WHMCS 6.0
    Improvements to all hook points

    Version 1.0.4 - Released 06.25.2015

    Added Braintree's Advanced Fraud Protection

    Version 1.0.2 - Released 05.18.2015

    Added option to disable / enable fee calculation
    Fixed an issue where an invoice may not be marked as paid when payment was successful

    Version 1.0.0 - Released 09.19.2014

    Initial Release
    1 Star2 Stars3 Stars4 Stars5 Stars (2 votes, average: 5.00 out of 5)