Skip to content
DisputeDashDisputeDash Docs

Connect Braintree

Braintree is configured in two parts: your API keys once at the workspace level, and each brand’s merchant account ID in Brands. One set of keys can serve many merchant accounts and brands.

What you’ll need

Section titled “What you’ll need”

From your Braintree Control Panel:

  • Merchant ID
  • Public key
  • Private key

(Settings → API → API Keys in Braintree.)

Step 1 — Connect your keys

Section titled “Step 1 — Connect your keys”
  1. In DisputeDash, go to Integrations → Payments → Braintree → Connect.
  2. Paste your Merchant ID, Public key, and Private key.
  3. Save.

Step 2 — Register the dispute webhook

Section titled “Step 2 — Register the dispute webhook”

DisputeDash shows you a webhook URL in the configure modal — copy that exact value. It looks like:

https://app.disputedash.com/webhooks/braintree

Then in Braintree:

  1. Go to Settings → Webhooks → Create new webhook.
  2. Paste the URL as the Destination.
  3. Under notifications, select all dispute events (dispute opened, won, lost, expired, under review).
  4. Save. Braintree sends a test “check” ping when you save — that’s expected.

There’s no separate webhook secret to enter. DisputeDash verifies every incoming webhook using your own Braintree keys, so a forged notification can’t get through.

Step 3 — Map each brand’s merchant account

Section titled “Step 3 — Map each brand’s merchant account”
  1. Go to Brands → Connections for the brand.
  2. Add a Braintree processor account and enter that brand’s merchant account ID.
  3. Repeat for each brand that uses Braintree.

Step 4 — Test

Section titled “Step 4 — Test”

Back on the Integrations Braintree card, select Test to confirm the connection works.