Braintree

BR-DGE integrates directly with Braintree, offering a powerful and flexible solution for online payment processing. This integration centralises your transactions within the BR-DGE platform, allowing you to fully leverage Braintree's extensive capabilities.

The following tables detail the integration methods and transaction features currently supported through BR-DGE's connection with Braintree.

If a desired Braintree feature is not listed or supported, please contact our support team for assistance.

Integration Methods

Braintree is supported for merchants integrating with the following methods:

Integration Method	Supported
REST API	✅
Web SDK	✅
Hosted Payment Page	✅

Payment Types

The following transaction types are supported with Braintree via BR-DGE:

Transaction Type	Supported
Direct Sale	✅
3-D Secure	✅
Split Auth & Capture (SaC)	✅
Merchant Initiated Transactions (MIT)	✅
Refunds	✅
Card Payouts	❌
Mail Order Telephone Order (MOTO)	✅

Payment Instruments

The following Payment Instruments types are available with Braintree via BR-DGE:

Payment Instrument	Supported
Cards	✅
PSP tokens	✅
Network tokens	✅
Apple Pay	✅
Google Pay	✅

Additional Information

Account Funding Transactions

BR-DGE supports Account Funding Transactions (AFTs) via Braintree, letting you correctly identify and process payments that fund a non-merchant account, such as a wallet top-up, or a person-to-person transfer.

To send an AFT to Braintree via BR-DGE, include the aft object, along with the required sender and recipient fields, in your POST /v1/payments API request.

When using Braintree with AFTs, note the following:

Braintree does not have external documentation, please speak to your Braintree representative for a solution design if required.
Braintree does not use a fundingPurpose.
Braintree does not confirm whether the payment was processed as an AFT in its response; BR-DGE will pass UNKNOWN back to you via the processedAsAft field.
It is possible for an AFT requested via Braintree to fallback and be processed as a standard purchase payment if the issuer is not enrolled to accept AFTs.

accountType mapping to Braintree:

BR-DGE value	Braintree value
IBAN	IBAN
EMAIL	EMAIL_ADDRESS
PHONE	PHONE_NUMBER
BAN_BIC	BIC_SWIFT_CODE
SOCIAL_NETWORK_ID	SOCIAL_NETWORK_PROFILE_ID
BANK_ACCOUNT	OTHER
CARD	OTHER
WALLET_ID	OTHER

fundingType mapping to Braintree:

BR-DGE value	Braintree value
PERSON_TO_PERSON	person_to_person
DIGITAL_WALLET_TOP_UP	wallet_transfer

For more information on Account Funding Transactions, refer to our dedicated AFT guide.

Card Schemes & Networks

BR-DGE support all major card networks enabled in your Braintree merchant accounts.

📘
You do not require any special configuration to enable different card networks through BR-DGE. All major card networks are supported on your retail channel(s) by default.

SCA Exemptions

You can request an SCA Exemption during authorisation with Braintree, potentially bypassing a 3-D Secure challenge.

To send an SCA Exemption to Braintree via BR-DGE, use the scaExemption field in your POST /v1/payments API request.

For more information on SCA Exemptions, refer to our dedicated SCA guide.

Testing

Once enabled on your BR-DGE retail channels, you can begin testing Braintree using their dedicated test cards and scenarios.

For a comprehensive overview of testing with Braintree, please visit their dedicated testing pages.

🚧
You should not use real card numbers for testing in the sandbox environment. Only use test cards supported by the payment processor.

Support

To enable Braintree on your BR-DGE retail channels, please contact support.