> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Link a Braintree account in the StackOne Hub using API Key (Basic Auth). End-user guide to authorize the integration and start using Braintree actions.

<Warning>Braintree keeps Sandbox and Production completely separate. A Merchant ID and API key created in one environment never work in the other, so create and copy your credentials in the same environment you select in StackOne Hub.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Sign in to the Braintree Control Panel</h2>

  <p>Your <strong>Merchant ID</strong>, <strong>Public Key</strong> and <strong>Private Key</strong> all come from the Braintree Control Panel.<br />Start by signing in to the environment you are connecting.</p>

  <Steps>
    <Step title="Sign in to the Control Panel">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Open the Braintree Control Panel for your environment, enter your <strong>Username</strong> and <strong>Password</strong>,<br />then click <strong>Log In</strong>.</p>

        <ul>
          <li><strong>Production</strong> — <a href="https://www.braintreegateway.com" target="_blank" rel="noopener noreferrer">Braintree production Control Panel</a></li>
          <li><strong>Sandbox</strong> — <a href="https://sandbox.braintreegateway.com/login" target="_blank" rel="noopener noreferrer">Braintree sandbox Control Panel</a></li>
          <li>If your team signs in through PayPal or a corporate domain, use <strong>Log In With PayPal</strong> or <strong>Log in with SSO</strong> on the same screen.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/oG8Uy_hOFWfKtPO9/connectors/braintree/images/custom-config-sign-in.png?fit=max&auto=format&n=oG8Uy_hOFWfKtPO9&q=85&s=bb8a45e571b70219b97416aaf5cf88ee" alt="Braintree sandbox login screen with the Username field, Password field and Log In button highlighted." width="1280" height="800" data-path="connectors/braintree/images/custom-config-sign-in.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Find your Merchant ID</h2>

  <p>The Merchant ID identifies your whole Braintree gateway account and lives on the <strong>Business</strong> page.</p>

  <Steps>
    <Step title="Open the settings menu">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the top-right corner of the Control Panel, click the <strong>settings menu</strong> gear icon.</p>

        <ul>
          <li>The menu lists <strong>Team</strong>, <strong>API</strong>, <strong>Fraud Management</strong>, <strong>Account Settings</strong>, <strong>Business</strong> and <strong>OAuth</strong>.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/oG8Uy_hOFWfKtPO9/connectors/braintree/images/custom-config-settings-menu.png?fit=max&auto=format&n=oG8Uy_hOFWfKtPO9&q=85&s=23bd1be9335534ebcaa69a3cd59bf610" alt="Braintree Control Panel home page with the settings gear icon in the top-right corner highlighted." width="1280" height="800" data-path="connectors/braintree/images/custom-config-settings-menu.png" />
      </div>
    </Step>

    <Step title="Open the Business page">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the settings menu, select <strong>Business</strong>. You will come back to this menu later for <strong>API</strong>.</p>

        <ul>
          <li>The <strong>Business</strong> page opens on the <strong>Merchant Accounts</strong> tab.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/oG8Uy_hOFWfKtPO9/connectors/braintree/images/custom-config-settings-api-business.png?fit=max&auto=format&n=oG8Uy_hOFWfKtPO9&q=85&s=23d5b5a75254970a5dcb70e07393108d" alt="Open Braintree settings menu with the API and Business entries highlighted." width="1280" height="800" data-path="connectors/braintree/images/custom-config-settings-api-business.png" />
      </div>
    </Step>

    <Step title="Copy your Merchant ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Under the <strong>Merchant ID</strong> heading, click <strong>Copy</strong> to copy the value shown in the field next to it.</p>

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

        <img src="https://mintcdn.com/stackone-60/oG8Uy_hOFWfKtPO9/connectors/braintree/images/custom-config-merchant-id.png?fit=max&auto=format&n=oG8Uy_hOFWfKtPO9&q=85&s=fd79726a9c6eba242da30ef006fa7b8d" alt="Braintree Business page with the Merchant ID field and its Copy button highlighted." width="1280" height="800" data-path="connectors/braintree/images/custom-config-merchant-id.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create and copy your API keys</h2>

  <p>The <strong>Public Key</strong> and <strong>Private Key</strong> are the username and password Braintree uses for server-side<br />API access. Both live on the <strong>API</strong> page of the settings menu.</p>

  <Steps>
    <Step title="Open the API keys page">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click the <strong>settings menu</strong> gear icon again, select <strong>API</strong>, and stay on the <strong>Keys</strong> tab.</p>

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

        <img src="https://mintcdn.com/stackone-60/oG8Uy_hOFWfKtPO9/connectors/braintree/images/custom-config-api-keys.png?fit=max&auto=format&n=oG8Uy_hOFWfKtPO9&q=85&s=9b0bee161983b2ea978d33bb645057e9" alt="Braintree API Keys page with the Generate New API Key button highlighted." width="1280" height="800" data-path="connectors/braintree/images/custom-config-api-keys.png" />
      </div>
    </Step>

    <Step title="Open your private key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>API Keys</strong> table, find your key and click <strong>View</strong> in the <strong>Private Key</strong> column.</p>

        <ul>
          <li>The <strong>Public Key</strong> is shown directly in the <strong>Public Key</strong> column of the same row.</li>
          <li>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.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/oG8Uy_hOFWfKtPO9/connectors/braintree/images/custom-config-view-private-key.png?fit=max&auto=format&n=oG8Uy_hOFWfKtPO9&q=85&s=da5f7e3ae49b452a907ec2d4a63aa9b5" alt="Braintree API Keys table with the Public Key value and the View link in the Private Key column highlighted." width="1280" height="800" data-path="connectors/braintree/images/custom-config-view-private-key.png" />
      </div>
    </Step>

    <Step title="Copy your credentials into StackOne Hub">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The <strong>Client Library Key</strong> page shows <strong>Public Key</strong>, <strong>Private Key</strong>, <strong>Environment</strong> and<br /><strong>Merchant ID</strong> together. Copy each value into the matching field in StackOne Hub.</p>

        <ul>
          <li><strong>Merchant ID</strong> — your Braintree gateway account identifier; paste it into the <strong>Merchant ID</strong> field in StackOne Hub.</li>
          <li><strong>Public Key</strong> — the username half of the Basic Auth pair; paste it into the <strong>Public Key</strong> field in StackOne Hub.</li>
          <li><strong>Private Key</strong> — the password half of the Basic Auth pair; paste it into the <strong>Private Key</strong> field in StackOne Hub and treat it like a password.</li>
          <li><strong>Environment</strong> — shows whether this key belongs to `sandbox` or `production`; select the same environment in StackOne Hub.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/oG8Uy_hOFWfKtPO9/connectors/braintree/images/custom-config-client-library-key.png?fit=max&auto=format&n=oG8Uy_hOFWfKtPO9&q=85&s=20880eab53cd293a90851c36c87235e8" alt="Braintree Client Library Key page with the Public Key, Private Key and Merchant ID values highlighted and redacted." width="1280" height="800" data-path="connectors/braintree/images/custom-config-client-library-key.png" />
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/connect/managing-connectors/linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>Merchant ID</strong></li>
        <li><strong>Public Key</strong></li>
        <li><strong>Private Key</strong></li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/gateway/concepts/linked-accounts">Accounts</a> page.</p>
</div>