# Connecting Braintree

> Connecting to Braintree uses API keys. If you have not had the values supplied to you, you will need a Braintree login with Account Admin access.

Connecting to Braintree uses API keys. If you have not had the values supplied to
you, you will need a Braintree login with **Account Admin** access.

To set up Braintree you will need:

- Your **Merchant ID**
- **Public Key**
- **Private Key**

If you don't have these, follow the steps below.

1. Log in to Braintree at
   [braintreegateway.com/login](https://www.braintreegateway.com/login).

2. Select **Settings → API**, then select **Generate API Key**.

   :::note[Tip]
   Don't share API keys between multiple systems.
   :::

   ![Braintree dashboard Settings menu with the API option highlighted](/_astro/cdn/0a26063e9e/connect-1.png)

3. Find the key you just generated and select **View**.

   ![API Keys screen with the Generate New API Key button highlighted](/_astro/cdn/98bf771929/connect-2.png)

   ![API Keys screen with the View link highlighted on the new key](/_astro/cdn/0146f2fb38/connect-3.png)

4. From the key detail screen, copy the values for your **Merchant ID**, **Public
   Key**, and **Private Key**.

   ![Client Library Key screen showing Public Key, Private Key, Environment, and Merchant ID](/_astro/cdn/794522ae1b/connect-4.png)

5. Enter these values in the Braintree connection screen. The connection is tested
   and you are shown a green **"Connected to Braintree"** message. If there is an
   error with the connection, an error message will appear.

   :::note[Tip]
   If the connection fails, make sure **Environment** says **live** — unless you know you are working in a sandbox environment.
   :::

   ![Connected to Braintree confirmation with currency merchant account mappings and AVS option](/_astro/cdn/cedb39a308/connect-5.png)

## Connection options

Our integration with Braintree offers several options:

- **Public Key:** Update if you change your credentials.
- **Private Key:** Update if you change your credentials.
- **Currencies:** Braintree only allows you to collect payment in the currency of
  one of your merchant accounts. We provide a list of each currency you have
  configured and let you select which merchant account to settle into (see below).
- **Enable PayPal:** Offers PayPal as a payment method, processed through your
  Braintree account.
- **Enable ACH:** Offers ACH bank debits (USD only). When you turn it on, enter your
  **Company name**: it is shown to the customer in the ACH debit authorisation they
  accept at checkout.
- **Require address (AVS):** Asks the customer for their billing postcode on card
  payments.
- **Enable 3D Secure:** Authenticates card payments with 3D Secure.

## Adding currencies

To add support for more currencies, go to **Settings → Business**.

![Braintree dashboard Settings menu with the Business option highlighted](/_astro/cdn/c40358b2ee/connect-6.png)

Here you can see the merchant accounts you have configured and add new ones. After
adding a new one, return to the Braintree connection screen and the new merchant
account will appear under its currency.

![Braintree Merchant Accounts screen with the New Merchant Account button highlighted](/_astro/cdn/07029884fb/connect-7.png)

For example, to support AUD, add a merchant account in AUD. (The screenshot below
is a test account; the live screen will vary slightly.)

![New Merchant Account form with a Merchant Account ID and AUD currency selected](/_astro/cdn/a1acb2e7e5/connect-8.png)