> For the complete documentation index, see [llms.txt](https://help.checkoutchamp.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.checkoutchamp.com/crm/gateway-setup/gateway-integrations/braintree.md).

# 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="/files/C5uD0Ll7lnGfoAoqnBDW" 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](/crm/gateway-setup/direct-api-3ds-instructions.md) (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="/files/2L2jLNuOw4iI8nOd0nUP" 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="/files/cs28pIXBVqnSjvzTDZjr" 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="/files/yTz7j0VxBZVhpzRgkK2P" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/OeefB0LinyiQup38hfwi" alt=""><figcaption></figcaption></figure>
