Connect Braintree with API Key (Basic Auth) – StackOne Hub

Open the Braintree Control Panel for your environment. On the Log into Sandbox (or production) screen, enter your Username and Password, then click Log In.

• Production — Braintree production Control Panel
• Sandbox — Braintree sandbox Control Panel
• If your team signs in through PayPal or a corporate domain, use Log In With PayPal or Log in with SSO on the same screen.
• If a cookie consent banner appears, click Accept or Decline to dismiss it.
• If the login screen appears even though you are already signed in, sign in again to reach the Control Panel home page.

In the top-right corner of the Control Panel, click the settings menu gear icon.

• The menu lists Team, API, Fraud Management, Account Settings, Business, OAuth and Audit Logs.

In the settings menu, select Business. You will come back to this menu later for API.

• The Business page opens on the Merchant Accounts tab.

Under the Merchant ID heading, click the copy icon to the right of the value (its tooltip reads Copy).

• Braintree describes this value as a unique identifier for your entire gateway account, required to connect your API calls to the Braintree gateway.
• Paste it into the Merchant ID field in StackOne Hub.
• Do not use a Merchant Account ID from the Merchant Accounts table further down the page — that identifies one merchant account inside your gateway, not the gateway itself.

In the top navigation bar of the settings area, click API, and stay on the Keys tab.

• Braintree lists your server credentials under API Keys, and notes that they are for server use only and should not be shared.
• If the API Keys table is empty, click Generate New API Key to create a key pair.

In the API Keys table, find your key and click View in the Private Key column.

• The Public Key is shown directly in the Public Key column of the same row.
• Each API key belongs to the user who created it, so use a key that belongs to the user account you want StackOne to act as.
• An API key has the same permissions as its owner’s user role. A key from a user with a restricted role connects successfully but fails on actions that role cannot perform, so use a key owned by an Account Admin or a role with access to the data you need.

The Client Library Key page shows Public Key, Private Key, Environment and
Merchant ID together. Copy each value into the matching field in StackOne Hub.

• Merchant ID — your Braintree gateway account identifier; paste it into the Merchant ID field in StackOne Hub.
• Public Key — the username half of the Basic Auth pair; paste it into the Public Key field in StackOne Hub.
• Private Key — the password half of the Basic Auth pair; paste it into the Private Key field in StackOne Hub and treat it like a password.
• Environment — shows whether this key belongs to sandbox or production. It must match the environment this StackOne connection uses; there is no Environment field to fill in.
• Native Webhook URL — read-only and filled in by StackOne. Leave it as is; you only need it later if you set up Braintree webhooks.