To install the ACH Payment Gateway for WHMCS, download the latest build of the module and licensing system from your ASPnix client area, extract the files, and upload them to your WHMCS web root while preserving directory structure. In the WHMCS admin area, activate the ACH Direct Debit Gateway under Setup => Payments => Payment Gateways, input your Braintree merchant ID, public key, private key, and ASPnix license. Activate the ACH Direct Debit Manager under Setup => Addon Modules. In Braintree, add custom fields invoice_id and user_id under Processing Settings, then create a webhook under Webhooks with the appropriate Destination URL and TRANSACTION events selected.

This integration links Braintree ACH processing directly to WHMCS invoices and client accounts. The custom fields ensure transaction mapping while webhooks deliver real-time status updates. Proper installation prevents orphaned payments and enables lower-cost direct debit as an alternative to credit cards for recurring hosting invoices. Always verify each component because mismatched configuration between WHMCS and Braintree will break payment flow.

#Prerequisites

Prepare your environment with the following:

  • Fully operational WHMCS installation with administrator login and file upload access to the document root
  • Approved Braintree merchant account with ACH direct debit processing enabled
  • Valid ASPnix product license for the ACH Payment Gateway module

#Downloading and Uploading the Module

Log into the ASPnix client portal and download the latest build of the ACH Payment Gateway module together with the licensing system. Extract the archive on your local machine. Using FTP or the server file manager, transfer every file and folder to the WHMCS web root. Maintain the original directory layout exactly; modules must land under the modules/gateways and modules/addons paths. Uploading to the document root ensures WHMCS locates the gateway classes and addon hooks without path errors. A common pitfall is flattening the folder structure during transfer, which causes the gateway not to appear in the admin list.

#Activating and Configuring Within WHMCS

Log in to the WHMCS administrator area. Navigate to Setup => Payments => Payment Gateways, locate the ACH Direct Debit Gateway in the available modules list, and activate it. Immediately enter the Braintree merchant ID, public key, private key, and your ASPnix product license into the configuration fields that appear. These credentials authenticate every transaction request. Next, go to Setup => Addon Modules, locate the ACH Direct Debit Manager, and activate it. The addon extends the gateway with additional transaction handling and reporting capabilities inside WHMCS.

#Braintree Configuration

Log into the Braintree control panel. Under Processing Settings locate the Custom Fields section and click Add New. Create two fields using the exact names shown in the module documentation: invoice_id and user_id. These fields allow the ACH module to tag each transaction with the originating WHMCS invoice and client identifiers so that payment status updates synchronize correctly. Next navigate to the Webhooks area and click Create New Webhook. Provide the Destination URL that points to the module's handler script on your WHMCS domain and enable the TRANSACTION event types. This registers Braintree to POST transaction outcomes back to the gateway.

#Testing the Integration

It is highly recommended that you test in a sandbox environment first; note that the API details for sandbox and production are different. Create a separate sandbox merchant account in Braintree, switch the WHMCS gateway settings to those sandbox credentials, and run end-to-end tests. Submit sample ACH transactions, confirm that the custom fields are received, verify webhook delivery, and check that WHMCS marks invoices paid and updates client records. After validation, replace the credentials with production values. Common failure points include using production keys in sandbox mode, an unreachable webhook URL due to .htaccess rules or firewall blocks, and custom fields that do not match the required names or data types.

Once the ACH gateway is installed, configured, and tested, monitor the first live transactions for any synchronization issues. Review the module's log files in WHMCS if payments do not appear as expected. This setup provides reliable ACH direct debit processing for your hosting clients; combine it with appropriate WHMCS invoice templates and email notifications for a complete billing workflow.