# Braintree

### Step 1 - Activate Braintree <a href="#braintree-step1-activatebraintree" id="braintree-step1-activatebraintree"></a>

Go to **Gateways** → **Gateway Integrations** and select Braintree. Click on **+ Activate**.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FX16vYphoA6qO5Vl0ATp1%2Fimage.png?alt=media&#x26;token=e813b7bc-fc69-4871-86e8-eb907228beb1" alt=""><figcaption></figcaption></figure>

### Step 2 - Add your Braintree credentials <a href="#braintree-step2-addyourbraintreecredentials" id="braintree-step2-addyourbraintreecredentials"></a>

Now the **Create New Gateway** page will appear. Double check that Braintree is selected in the gateway field and fill in the rest of the info on the gateway profile.

Obtain **merchant\_id**, **public\_key**, and **private\_key** from Braintree (additional notes on this below)

Obtain **merchant\_acct\_id** from Braintree.  This may be optional depending on your setup at Braintree.  The merchant account ID is a unique identifier for a specific merchant account at Braintree. It is used to specify which merchant account to use when creating a transaction. It is not the same value as **merchant\_id**.

Choose to process with Braintree native 3DS using the **secure3DS** box. 3DS requires the checkout page to support [standard redirect handling](https://help.checkoutchamp.com/crm/gateway-setup/direct-api-3ds-instructions) (not required if using Checkout Champ hosted pages).

Check the **storeInVaultOnSuccess** box if you need one-click upsells or recurring billing on this gateway. This enables the customer vault at Braintree.

Choose to **sendProductDetails**

Choose to use Braintree’s test server. Be sure to uncheck **useTestServer** when ready for live traffic.

Enter **Title** and **Descriptor**

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FDpxg0vYEq3fPai6a02zl%2Fimage.png?alt=media&#x26;token=e2aedfd5-4124-4150-ba50-adf49f943bc4" alt="" width="375"><figcaption></figcaption></figure>

***

**Here are the steps to get your Braintree keys.**

{% hint style="warning" %}
These steps may change if Braintree's platform is updated.
{% endhint %}

Step 1: Log in to your Braintree account.&#x20;

Step 2: Click on the Settings icon and select ‘API’ from the list that flows down.&#x20;

The API keys page will appear.

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2F3HFHcekTJLphBrnkwVvc%2FUntitled.png?alt=media&#x26;token=643f2ea6-d090-4042-9742-bcb918e411bc" alt=""><figcaption></figcaption></figure>

Step 3: Under the API keys, click on the ‘view’ button. You can get the public key, private key and merchant id there

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FrboBKP9qcM6bqzBRKdvA%2FUntitled-1.png?alt=media&#x26;token=dcd00021-6000-40f7-b4b2-04daebb32e6f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3790748257-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT43PzcNjyZtWby9yrGd3%2Fuploads%2FX7IWSV3f28cwTwPJflfp%2FUntitled.png?alt=media&#x26;token=a0d17cc6-4941-4a13-9d54-ac2d67c72e44" alt=""><figcaption></figcaption></figure>
