There are several different identifiers associated with your Braintree account. Here are some important ones you'll need to know.

API credentials

API credentials are unique account identifiers that must be added to your code before you can process payments via the API. Think of them as your username and password to payment processing. The four API credentials are:

Environment

The environment specifies where requests via the API should be directed – sandbox or production. Because you have a different set of API keys for each environment, you'll need to update your code depending on which environment you're working in.

There are both production and sandbox environments for the Control Panel and the API. Learn more about the differences between sandbox and production.

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. Because this affects your integration, it should be done with caution. Learn more about rotating API keys.

important

Sandbox API keys are different from those in the production environment, so they must be updated in your code by your developers when switching between environments. More information about switching environments is available in our developer docs.

Public key

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

To find your public key:

  1. Log into either the production Control Panel or the sandbox Control Panel, depending on which environment you are working in
  2. Navigate to Account > My User
  3. Under API Keys, Tokenization Keys, Encryption Keys, click View Authorizations

You'll find your public key under the API Keys section at the top. If no API keys appear, click Generate New API Key.

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 an API call – even with us.

To find your private key:

  1. Log into either the production Control Panel or the sandbox Control Panel, depending on which environment you are working in
  2. Navigate to Account > My User
  3. Under API Keys, Tokenization Keys, Encryption Keys, click View Authorizations
  4. In the API Keys section, click View under the Private Key column

Your private key will be revealed in the Private Key column on the next page.

Merchant ID

note

Your merchant ID is not the same as your merchant account ID. See below for the differences.

Your merchant ID is the unique identifier for your entire gateway account, including the multiple merchant accounts that may be in your gateway. Often referred to as the public ID or production ID, your merchant ID will be different for your production and sandbox gateways. If you contact our Support team for assistance, we may ask you to confirm this credential for your gateway account.

To find your merchant ID:

  1. Log into either the production Control Panel or the sandbox Control Panel, depending on which environment you are working in
  2. Navigate to Account > My User
  3. Under API Keys, Tokenization Keys, Encryption Keys, click View Authorizations

You'll find your merchant ID in the Client-Side Encryption Keys section.

Your merchant ID can also be found when logged into your Control Panel, as the string of letters and numbers following /merchants/ in the URL.

Additional credentials

Depending on your integration, you may need to provide other credentials in addition to those listed above.

Merchant account ID

note

Your merchant account ID is not the same as your merchant ID. See below for the differences.

A single Braintree gateway can have multiple merchant accounts to process transactions for different businesses or currencies. Each merchant account within a gateway can be identified by its unique merchant account ID.

You can use this ID to specify a merchant account when creating a transaction. If you have a single merchant account, it is not necessary to specify a merchant account ID in your API requests. If you have multiple merchant accounts and choose not to specify the merchant account ID, all requests will process through your default merchant account.

Even if you only have one merchant account in your gateway, certain shopping cart integrations may require you to provide your merchant account ID.

To find your merchant account ID(s):

  1. Log into either the production Control Panel or the sandbox Control Panel, depending on which environment you are working in
  2. Navigate to Settings > Processing > Merchant Accounts

You'll see the merchant account IDs in the first column for each account.

Merchant account ID versus merchant ID

While merchant account ID and merchant ID sound similar, they are different values with distinct purposes, and are often confused with one another.

Your merchant ID is a unique identifier for your entire gateway account. This value is required to connect your API calls to the Braintree gateway, along with the values listed above.

Your merchant account ID is a unique identifier for a specific merchant account in your gateway, and is used to specify which merchant account to use when creating a transaction.

Tokenization keys

Tokenization keys can be used for authorization in your Braintree integration. They authorize the client SDK to tokenize payment information for use on your server.

To view your tokenization keys:

  1. Log into either the production Control Panel or the sandbox Control Panel, depending on which environment you are working in
  2. Navigate to Account > My User
  3. Under API Keys, Tokenization Keys, Encryption Keys, click View Authorizations

You should see your key under the Tokenization Key section. If no key appears, click Generate New Tokenization Key.

Client-Side Encryption key

The Client-Side Encryption (CSE) key is required if you are using our older integration method. Similar to the merchant ID, this value is unique to your entire Braintree gateway account, not to a specific user. Some shopping cart integrations may also require the CSE key in order to connect to Braintree.

To find your CSE key:

  1. Log into the Control Panel
  2. Navigate to Account > My User
  3. Under API Keys, Tokenization Keys, Encryption Keys, click View Authorizations

You'll find the CSE Key field under the Client-Side Encryption Keys section.

Still have questions?

If you can’t find an answer, contact our Support team.


← Back to Previous Page