Braintree (deprecated)

Deprecation Notice

While current integrations with this provider will continue to be maintained, no new integrations will be possible.

API Version

Minimum required API version: 1.1.0

The following features require an API version higher than the minimum:

3DS 2.0 External requires API version 1.3.0

Payment Methods

The following table lists all supported payment methods.

Payment Method	Payment Method Type	Notes
American Express	Cards
DINERS	Cards	EU merchant accounts only support EUR, GBP, USD.
DISCOVER	Cards	EU merchant accounts only support EUR, GBP, USD.
JCB	Cards
MAESTRO	Cards	Supported with EU merchant accounts only.
MASTERCARD	Cards
VISA	Cards

Currencies

See Braintree Currencies.

Features

The following table provides an overview of all supported and non-supported features.

Feature	Supported
3DS 2.0 External	Yes
3DS 2.0 PaymentsOS-handled	No
3DS 2.0 Provider-handled	No
3DS 2.0 Self-handled	No
Installments	No
Level 2 and 3 Data	No
Multi-seller Payments	No
Network Tokens	No
Payment Facilitator	No
PayU Risk	No
Pre-authorization	No
Retrieve Supported Payment Methods	No
Retrieve Supported Plans	No
Statement Soft Descriptor	No
Stored Credentials Flag	No
Transaction Processing without CVV	No

Requests

The following table lists all supported requests for card-based transactions. Use the bodybuilder to create a sample request body for each request type.

Request	Partial/Multiple	Mode	Notes
Authorize	Partial and multiple are not supported	Synchronous	Installments are not supported.
Capture	Partial and multiple are not supported	Asynchronous
Charge	Not Applicable	Asynchronous	Installments are not supported.
Refund	Multiple is supported	Asynchronous
Void	Not Applicable	Synchronous

Setup Procedures

The following table lists the setup procedures that are specific to this provider.

Configuration	Required/Optional
In the PaymentsOS Control Center, configure the following credentials: merchant_id: The Merchant id as defined in Braintree. public-key: Public key as defined in Braintree. private-key: Private key as defined in Braintree. merchant_account_id (optional): The Merchant account id as defined in Braintree. It represents a specific currency in your Braintree account. currency: Currency as defined in Braintree. Notes: You should have received a set of test credentials for each Braintree merchant account (one account per currency). Use these credentials to create separate provider configurations in the PaymentsOS test environment. For your test credentials, login to your Braintree test account and click Account > My User > View Authorizations. For your live credentials, login to your Braintree live account. To see your Braintree Merchant accounts click Settings > Processing.	Required
In your Braintree account, make sure the following unsupported features are disabled: Hosted Fields Fraud Tools Alternative Payment Methods	Required
In the PaymentsOS Control Center, create webhooks to be notified when a transaction changes its status. Note: Charge, Capture, and Refund are usually pending.	Optional
In your Braintree account, turn on the Duplicate transaction checking feature. Set the Duplicate transaction checking interval to at least 1 hour. For details, see Configuring duplicate transaction checking.	Optional

Testing

Use the testing resources provided in the Braintree Sandbox documentation:

Last modified June 27, 2024