Braintree integration
Marketplace + vault payments with attribution intact.
Braintree powers a lot of marketplaces and SaaS apps with PayPal under the hood. HeldSway listens to Braintree transaction webhooks, attributes them to the right affiliate, and handles the refund/dispute lifecycle automatically.
What the Braintree integration handles.
Transaction-level attribution
Each Braintree transaction maps to its referring affiliate via cookie or coupon code with the same tie-break rules as the rest of HeldSway.
Recurring billing support
Braintree subscriptions feed renewal events into HeldSway; recurring affiliate commissions accrue cycle by cycle.
Refund & dispute reversal
Refunds and successful chargeback disputes inside Braintree automatically reverse the affiliate commission.
Vault-token aware
Repeat purchases via Braintree Vault keep the original affiliate attribution unless your rules say otherwise.
Multi-currency settlements
Braintree settling in 130+ currencies? HeldSway logs the affiliate amount in the settlement currency.
Webhook signature verification
All inbound Braintree notifications are verified to prevent spoofed events.
How to connect
Three steps to live tracking.
- 01
Generate Braintree API credentials
In Braintree Control Panel → Settings → API, create a read-scope key set. Public key + private key + merchant ID.
- 02
Add them to HeldSway
Integrations → Braintree → paste credentials. HeldSway tests the connection and registers a webhook URL automatically.
- 03
Process a sandbox transaction
Run a test transaction in Braintree sandbox. Watch the event appear in HeldSway with the correct affiliate attribution.
Compatible with
- Braintree Direct (US/CA/EU/AU/UK)
- Braintree Marketplace
- Vault-stored customers
- Recurring billing
- PayPal Express via Braintree
Pairs naturally with
Braintree affiliates without the spreadsheet.
Free trial includes the Braintree integration on Standard and above.