Step 2: Configure Braintree ACH Direct Debit

The Braintree ACH Direct Debit provider allows customers to pay directly from their US bank accounts.

Important

ACH Direct Debit must be enabled on your Braintree Account by Braintree Sales before live transactions can be processed.

ACH Provider Configuration

  1. Navigate to Accounting ‣ Configuration ‣ Payment Providers.

  2. Open Braintree - ACH Direct Debit.

  3. Under the Credentials tab, paste your Merchant ID, Public Key, and Private Key.

    Braintree ACH Provider Credentials

  4. Open the Messages tab to customize the Pending Message displayed to customers during the 3-5 business day settlement window.

    ACH Messages Configuration

Mandate Text

US banking regulations require customers to agree to an authorization mandate before processing an ACH payment.

  1. Open the Configuration tab.

  2. Locate the ACH Direct Debit (US only) section.

  3. Review or customize the ACH Mandate Text. The module automatically provides a standard, NACHA-compliant default text.

Webhook Configuration

Because ACH payments take 3 to 5 business days to clear, configuring a webhook is required to automatically mark the Odoo transaction as Done once the funds actually settle.

  1. On the Configuration tab of the provider, copy the pre-generated Webhook URL.

  2. Log into your Braintree Control Panel and navigate to Settings ‣ Webhooks.

  3. Click New Webhook and paste your Odoo Webhook URL.

  4. Select the following notification events:

    • Transaction Settled

    • Transaction Settlement Declined

    • Disbursement

    • Disbursement Exception

    • Dispute Opened

    • Dispute Lost

    • Dispute Won

  5. Click Create Webhook.

See also