Braintree Credit Card Processing Gateway Integration

Braintree is available to US, European, Australian, and Canadian merchants. We help companies of all sizes grow into international markets and accept payments in over 130 currencies. We pay out fast - just 2 business days for most transactions. No matter your stage of growth, we can help you optimize your cash flow to grow your business.

Integrating Braintree with your UltraCart Account:

The first step will be creating your brain tree account and acquiring your Braintree API keys, which you will place into UltraCart. 

You'll need 3 credentials to connect your Braintree account to UltraCart: the Merchant ID, Public Key and Private Key. 

Obtaining your API Key credentials:

Next, you'll gather your credentials by logging into your Braintree account: https://www.braintreegateway.com/login

Braintree API Keys

The public and private keys together make up your user's API keys. Each user associated with your Braintree gateway will have their own set of API keys, which they can change or rotate at any time for added security. 

Braintree Docs: API Keys

1. Braintree Merchant ID

Your merchant ID is the unique identifier for your entire gateway account, including the multiple merchant accounts that may be in your gateway.

Braintree Docs: Merchant ID

1. Click on the gear icon in the top right corner

2. Click Business from the drop-down menu

3. Scroll to the Merchant Accounts section

2. Braintree Public Key

This is your user-specific public identifier. Each user associated with your Braintree gateway will have their own public key.

Braintree Docs: Public Key

1. Click on the gear icon in the top right corner

2. Click API from the drop-down menu

3. Scroll to the API Keys section

3. Braintree Private Key

This is your user-specific private identifier. Each user associated with your Braintree gateway will have their own private key. Your private key should not be shared outside the use of the UltraCart UI.

Braintree Docs: Private Key

1. Click on the gear icon in the top right corner

2. Click API from the drop-down menu

3. Scroll to the API Keys section

4. Click the View link located in the Private Key column

Placing the API credentials into UltraCart:

Login into your UltraCart account and navigate:

Configuration > Checkout > Payments

Open

Select Braintree Payment Solutions (Blue)

Open

Enter:

• Braintree MerchantID

• Braintree Public Key

• Braintree Private Key

• Select the Credit Card types you are setup to process through Braintree (typically Visa, MasterCard, Discover, Amercian Express)

Then hit the save button at the bottom of the page to save the changes.

Preventing Duplicate Transactions

In Braintree you can turn on a setting to prevent duplicate charges:

NOTE: Duplicate transaction checking is enabled by default with a 30-second window. This setting can be updated or disabled by users with Account Admin privileges.

1. Log into the Braintree Control Panel

2. Navigate to Settings > Processing > Duplicate Transaction Checking

3. Click Edit to adjust the time window or Enable/Disable to turn the feature on/off

Troubleshooting & Support

Online Braintree support is available at https://support.braintreepayments.com/

You can learn more about customizing the AVS and CVV rejection rules here: https://support.braintreepayments.com/customer/portal/articles/1080668

About decline responses: https://support.braintreepayments.com/reference/general/processor-responses/authorization-responses#declines

https://articles.braintreepayments.com/control-panel/transactions/declines