Braintree

Braintree has some special integration requirements. Follow the standard PaymentsOS integration procedure, and then apply the relevant extra specifications described below.

Specifications for Card-based Transactions

The following table lists the integration specifications for Braintree.

SpecificationsDetails
Minimum PaymentsOS API Version1.0.0
Requests
  • Authorize
  • Capture
  • Charge
  • Refund (including multiple)
  • Void
Limitations:
  • Multiple Captures are not supported.
  • Installments are not supported
CurrenciesSee Braintree Currencies.
Payment MethodsUS merchant accounts:
  • AMEX
  • DINERS
  • DISCOVER
  • JCB
  • MASTERCARD
  • VISA
EU merchant accounts:
  • AMEX
  • DINERS (only EUR, GBP, USD
  • DISCOVER (only EUR, GBP, USD)
  • JCB
  • MAESTRO
  • MASTERCARD
  • VISA
3DS RedirectionNot supported

Configurations

The following table lists the configurations that are specific to Braintree.

ConfigurationRequired/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, register 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

Sample Requests

Use the bodybuilder to create a sample request body for each request type.

Testing

Use the testing resources provided in the Braintree Sandbox documentation:

results matching ""

    No results matching ""