Scope

How to enable ACH payments via Braintree gateway?

What are the prerequisites using ACH payments in Braintree Gateway?

What are the integration option that supports ACH payments via Braintree?

Types of bank account verification method for ACH payments on Braintree

What are fields required for ACH payments via Braintree?

Summary

ACH is a US-based payment method available for processing recurring or one-time payments. Chargebee allows you to configure ACH (Direct Debit) payments using Braintree. This document helps you to set up ACH payments via Braintree in your Chargebee account.

This feature is a Private Beta Release. Contact support  to enable ACH via Braintree for your Test and Live site.

Once enabled, Go to Settings > Configure Chargebee > Payment Gateways > Braintree > Enable Direct Debit (ACH/eCheck).

Solution

Prerequisites

To accept ACH payments using Chargebee, you must:

1. Be a US-based merchant selling to customers based out of the US.
2. Have a US or USD bank account configured with Chargebee.
3. Have configured the Braintree payment gateway in your Chargebee account. Learn more

Accepting ACH Payments in Chargebee

Once enabled, Go to Settings > Configure Chargebee > Payment Gateways > Braintree > Enable Direct Debit (ACH/eCheck).

1. Enter your Business Name, Merchant Account ID, Email, and Phone. The Business Name field value is used in the ACH authorization agreement.

   

Bank Account Verification

Braintree offers bank account verification via the following three methods:

1. Network Check: In this method, customers are required to enter the necessary information (such as routing number, account number, etc.) during checkout. This information is shared with Braintree and the verification is performed instantly.
2. Independent Check: In this method, you are allowed to get their customers' bank accounts verified independently either by themselves or via a third-party verification service provider. The customer shares the third-party service provider's account's login credentials with Braintree to confirm the independent check. Once confirmed, Braintree generates a nonce. The merchant can either pass the nonce to Chargebee using Chargebee JS directly, or vault the payment method in Braintree and share the permanent token i.e reference ID (cus_id or src_id) with Chargebee for vaulting the payment method in Chargebee.

While setting up Direct Debit (ACH/eCheck), you can choose if you want Braintree to perform verification or if you want to do it independently by enabling or disabling the Verify customers' bank accounts using Braintree toggle button.

If enabled, your customer's bank accounts will be verified via Network Check during checkout. If disabled, you need to verify the accounts via Independent Check.

Click Save.

Additional Configuration

If you intend to use Chargebee's Hosted Pages for your integration, some fields must be configured as mandatory in Chargebee's checkout settings.

Follow the steps below to complete this:

1. Click Settings > Configure Chargebee > Checkout & Self-Serve Portal > Fields > Payments.

2. Enable First Name and Last Name within the Fields settings.

   

3. Enable Address Fields.

4. Click the Edit icon and confirm Address Line 1, Address Line 2, City, Zip, State, and Country are listed as Show from the drop-down list.

   

5. Click Publish.

Note: Make sure you enable the Address Fields without fail to ensure successful tokenization at Braintree's end. If these fields are not enabled or if an invalid value in entered by the customer, it can result in tokenization failure.

Bank Account Verification Method

The method used for verification depends on the merchant's configuration. Let us see the possible scenarios and the suitable verification methods:

1. For an API-based integration,
   a. you can share your bank account details with Chargebee which is then passed to Braintree for Network Check.
   b. you can get your bank account verified independently (i.e Independent Check) through a third-party service provider and vault the payment method directly or via Chargebee at Braintree.
2. If the merchant uses Chargebee's checkout and has enabled the Verify customers' bank accounts using Braintree toggle as shown above, the verification will take place only via Network Check. This is because we require quick verification during checkout when a merchant is about to make a purchase for a subscription.
3. If the merchant uses Chargebee's checkout and has disabled the Verify customers' bank accounts using Braintree toggle and chooses to perform verification independently, the following steps will take place:
   a. The customer logs into their third-party verification service provider's account and completes the verification.
   b. Once done, the customer shares the login information with Braintree.
   c. Braintree passes a nonce, based on which the payment method is vaulted and the transaction is processed.
4. If the payment method is added using Customer Portal (Hosted Pages), the verification is performed using Network Check.