Braintree Payment Gateway Add-on

Configure the Braintree gateway add-on for TruPayments.

Braintree gateway settings in TruCMS with sensitive credential values hidden

The Braintree add-on exposes its gateway configuration inside TruCMS after activation.

The Braintree add-on extends TruPayments with Braintree processing. Install and activate the add-on through the Plugin Manager, then configure its payment settings before enabling a customer-facing method.

Requirements

You need an appropriate Braintree merchant/account setup and the credentials shown below. Never paste real secrets into screenshots or support messages.

Configuration Fields

SettingGuidance
ModeChoose Sandbox while testing and Live when real payments are ready.
Webhook URLRead-only URL shown by TruCMS; copy it into the gateway dashboard if webhook notifications are configured.
Sandbox Merchant IDCredential used only while the gateway Mode is Sandbox.
Sandbox Public KeyCredential used only while the gateway Mode is Sandbox.
Sandbox Private KeyCredential used only while the gateway Mode is Sandbox.
Live Merchant IDCredential used only while the gateway Mode is Live.
Live Public KeyCredential used only while the gateway Mode is Live.
Live Private KeyCredential used only while the gateway Mode is Live.
Merchant Account IDOptional Braintree merchant account used when multiple settlement accounts exist.
Submit for SettlementControls whether Braintree transactions are submitted for settlement automatically.

How the gateway becomes available to customers

Installing/configuring the gateway add-on provides the processing capability. Then create or edit the customer-facing TruPayments Payment Method that uses this gateway. The method must be Enabled and eligible for the checkout’s module Scope, currency, and any Billing Zone restriction.

Changing credentials does not rewrite transaction history

Gateway configuration affects new processing attempts. Existing TruPayments transaction/refund records remain the place to review what happened on previous payments.

  1. Set Mode to Sandbox.
  2. Enter the sandbox/test credentials for the gateway.
  3. If applicable, configure the displayed Webhook URL in the provider dashboard.
  4. Create or edit the corresponding TruPayments Payment Method and enable it only for intended scope/currencies.
  5. Complete a low-risk sandbox payment through a connected module such as Booking or TruCommerce.
  6. Confirm the TruPayments transaction status and return/cancel behavior.
  7. Only after the sandbox flow is successful, enter live credentials and change Mode to Live.

Do not mix environments

Sandbox credentials belong with Sandbox mode; Live credentials belong with Live mode. Switching Mode changes which credential set TruPayments expects.