Integrating Braintree
Auth: API key · Partner program: not required · Setup time: about 15 minutes · Last verified: 2026-05-15
Braintree (PayPal-owned) — subscription-heavy gateway with strong multi-currency support. Primary API is GraphQL.
Auth model
Section titled “Auth model”Merchant credentials (Basic auth derived from public_key:private_key). Submit via Connect Link form; the adapter base64-encodes them as the bearer token.
Configure in admin
Section titled “Configure in admin”- Sign in at https://www.braintreegateway.com.
- Go to Account → My User → View Authorization to see your
merchantId,publicKey, andprivateKey. Use the Sandbox dashboard for testing. - Open
/platforms→ Payments → Braintree → Configure and submit:environment—productionorsandboxmerchantIdpublicKeyprivateKey
Webhooks
Section titled “Webhooks”Configured under Settings → Webhooks. Braintree signs each delivery with a bt_signature query parameter; the adapter verifies it against the merchant’s public key.
Subscribe to:
transaction_*(charges)subscription_*dispute_*disbursement_*(payouts)
Quirks
Section titled “Quirks”- GraphQL-first. Braintree’s GraphQL surface is the canonical API; the legacy REST/SDK endpoints are wrappers. The adapter implements
getChargevia GraphQL;listChargesis backed by webhook-derived sync. - Decimal money. Transactions return
amount.valueas a decimal string in major units. The adapter converts to minor units. Braintree-Versionheader is pinned to2019-01-01— the most recent stable schema version at the time of writing.
References
Section titled “References”- Developer portal: https://developer.paypal.com/braintree/docs
- GraphQL reference: https://graphql.braintreepayments.com/reference/
- Webhooks: https://developer.paypal.com/braintree/docs/guides/webhooks/overview
opensteward.dev ·Plans and free license ·Terms ·Privacy ·support@opensteward.dev
© 2026 Falco Consulting AB. Built from open-steward/opensteward@a3961d8. This site sets no cookies, runs no analytics and loads nothing from other sites, except platform logos from Brandfetch on the Platforms page.