Braintree Affiliate Program: How to Set It Up in 2026

TL;DR. Braintree is PayPal’s payment gateway, not affiliate software, so partner tracking and payouts always come from a tool you add on top. The wrinkle that defines Braintree: it sends webhooks for subscriptions and disputes, but none for one-time card sales or card refunds.

So you track recurring sales through Braintree’s subscription webhooks, route one-time sales through a server-to-server API, let chargebacks claw back automatically, and reconcile the occasional card refund by hand. Connect with read-only API keys, pass the referral through a custom field, and a Braintree affiliate program runs cleanly once you respect those edges.

Braintree quietly powers a large slice of online checkout. It belongs to PayPal, which moved roughly $1.79 trillion in total payment volume in 2025 (PayPal), and it handles cards, PayPal, Venmo, and bank payments behind a single gateway. If you bill through Braintree, an affiliate program is a natural next step, as long as you know where Braintree helps and where it quietly steps back.

Here is the honest version most setup pages skip. Braintree gives you solid recurring-subscription tracking and automatic chargeback handling, but it leaves real gaps around one-time sales and refunds. This guide walks through how a Braintree affiliate program actually works in 2026, how to track and pay one accurately around those gaps, which tools support Braintree at all, and how to launch your own.

Does Braintree have a built-in affiliate program?

No. Braintree is a payment gateway, owned by PayPal. Its job is moving money: cards, digital wallets like PayPal and Venmo, and bank payments, with a stored-card vault, recurring billing, and fraud tools. Managing affiliates is not part of the picture. Nothing inside Braintree recruits partners, hands out referral links, works out commissions, or pays anyone.

Braintree does have a partner program, but it is aimed at software and platform companies that embed Braintree in their own products, not at people promoting your product for a commission. That is a different thing entirely.

So a Braintree affiliate program is always Braintree plus a dedicated tool that listens to your Braintree activity and turns it into tracked, payable commissions. How well that works depends almost entirely on one thing: which events Braintree is willing to tell that tool about.

The Braintree quirk that changes everything: its webhooks

This is the most important thing to understand about Braintree, and almost no guide states it plainly. Braintree only sends webhooks (it calls them notifications) for certain events, not all of them.

It fires them for subscription activity and for disputes. It does not fire a webhook when a one-time card sale succeeds, and it does not fire one when you refund a card payment. Transaction-level webhooks exist only for bank-debit methods such as ACH and SEPA, which most subscription businesses do not lean on.

The rule of thumb falls out of that table: Braintree is excellent for recurring, subscription-based affiliate programs straight away, while one-time sales and voluntary refunds need a deliberate workaround. Both are easy to handle once you know they are coming, and the rest of this guide shows how.

How Braintree affiliate tracking actually works

Tracking has two parts: capture the referral, then read it back. The affiliate tool’s script records the click on your marketing site, you carry that reference into the Braintree sale, and the tool reads it from the webhook to credit the right affiliate. Three details make this work on Braintree specifically.

• Connecting is by API key, not OAuth. Braintree’s one-click authorization has sat in limited beta for years, so in practice you connect with credentials: a merchant ID and a public and private key pair, ideally generated for a dedicated read-only user. Read access is enough to verify the account and parse webhooks, and it keeps the damage small if a key ever leaks.
• Attribution rides on a custom field. Braintree has no free-form metadata bag on every object, so the standard approach is to create a custom field in the Control Panel, set it to “store and pass back”, and stamp the affiliate’s reference onto the sale. The tool reads that field off the transaction tied to the subscription. If it is missing, a good tool falls back to matching a returning customer to the affiliate who first referred them.
• You add the webhook by hand. Because there is no usable OAuth, the tool cannot register its own webhook. You paste the tool’s webhook URL into Braintree’s Control Panel and tick the subscription and dispute notifications yourself. It is a few minutes of setup, once.

In practice it looks like this: a visitor clicks an affiliate link and lands on your site, the tool drops a cookie, and when that visitor subscribes through Braintree your checkout writes the affiliate’s reference into the custom field. Braintree’s next subscription webhook carries that reference, the tool matches it to the affiliate, and the commission appears. Every renewal after that repeats the final step, with no extra work from you.

Tracking one-time sales, where Braintree leaves a gap

Because Braintree sends no webhook for a one-time card sale, a tool that only listens for webhooks will simply miss those sales. There are two honest ways to close that gap.

• Server-to-server tracking (recommended). Your backend already knows the instant a one-time sale succeeds, so it posts a signed conversion straight to your affiliate tool’s API at that moment. This is the most reliable method because it does not wait on Braintree to emit anything, and it is the same approach mature tools use for custom checkouts.
• A browser pixel. A snippet fires a conversion from the success page. It is quick to add but the least dependable, since ad blockers and closed tabs drop events. Keep it as a backup, never the system of record.

If most of your revenue is one-time rather than recurring, weigh this when you pick a tool. You want one with a clean server-to-server API, not one that quietly assumes every sale is a subscription.

Commissions, refunds, and chargebacks

Once tracking is in place, three money events decide whether your numbers stay honest over time.

• Recurring commissions. When Braintree charges a subscription, the webhook lets your tool accrue a commission, and it keeps doing so on each renewal for the window you set. Cancellations and expirations stop future commissions while leaving what was already earned in place.
• Chargebacks. These do arrive, as dispute webhooks. When a dispute is lost, your tool reverses the related commission automatically, so you are not left paying out on money that got pulled back.
• Refunds. Here is the gap again. Braintree sends no webhook when you voluntarily refund a card sale, so no tool can catch it automatically. FirstPromoter says exactly this in its own documentation. Refunded sales need a manual step: you deny or reverse the affiliate’s commission yourself.

The fix is a small monthly routine. Export your refunds from Braintree, match them against paid or pending commissions in your affiliate tool, and deny the ones tied to refunded sales before you run payouts. It takes a few minutes and protects your margin. Build it into your payout process so it never gets skipped.

When you export, match on the original transaction or order reference, since that is the key both Braintree and your affiliate tool share. Most tools let you search a commission by that reference, so the monthly pass is usually a quick filter-and-deny rather than a line-by-line hunt.

Worth knowing. Run refunds and payouts on the same cadence: reconcile refunds first, then pay. That one habit closes Braintree’s biggest affiliate gap without any extra tooling.

Why the affiliate-tool ecosystem for Braintree is thin

It is worth setting expectations: far fewer affiliate tools support Braintree than support Stripe. The modern, SaaS-focused wave of tools, for example Rewardful, Tolt, and Affonso, is built Stripe-first and skips Braintree entirely. The tools that do support it natively tend to be the longer-established ones, such as FirstPromoter and Post Affiliate Pro, plus a few platforms that bundle checkout and affiliate tracking together.

Why so few? Braintree’s webhook gaps and the lack of usable OAuth make it more work to support well, so newer tools chasing the largest market started with Stripe and often stopped there. That does not make Braintree a bad choice; it just means your shortlist is shorter, and you should confirm Braintree support explicitly rather than assume it. If a tool can also ingest conversions over an API, you are not limited to native integrations at all, since that route works no matter the processor.

Braintree vs Stripe for running an affiliate program

Both are excellent gateways. For an affiliate program in particular, the differences come down to webhook coverage and the tool ecosystem.

Braintree tends to win when you already run on it, or when you want PayPal and Venmo as first-class payment options and your revenue is mostly subscriptions. Stripe tends to win when you want the widest tool choice and the most webhook coverage with the least manual work, as our Stripe affiliate program guide explains. If you are weighing the tooling side, our guide to the best affiliate software for SaaS lays out the options.

Is a Braintree affiliate program right for you?

A quick gut check before you build, since the answer changes how much work it is:

• You already bill on Braintree and sell subscriptions. This is the sweet spot. Recurring tracking and chargeback clawbacks work out of the box, and there is little to reconcile by hand.
• You are on Braintree but sell mostly one-time products. Still workable, but plan for the server-to-server route and the monthly refund reconciliation from day one, since those carry more of the load.
• You are still choosing a processor and an affiliate program is central. If nothing ties you to Braintree, Stripe gives you a wider tool choice and less manual work. Choose Braintree for its strengths, an existing setup or native PayPal and Venmo, not in spite of its affiliate gaps.

How to launch your Braintree affiliate program step by step

1. Pick a tool that supports Braintree. Confirm it natively reads Braintree subscription and dispute webhooks, and ideally that it offers an API for one-time sales.
2. Create a read-only Braintree user and keys. Generate a merchant ID and a public and private key pair for a dedicated read-only user, then paste them into your tool.
3. Add the webhook and the custom field. Paste the tool’s webhook URL into Braintree’s Control Panel, tick the subscription and dispute notifications, and create the referral custom field set to store and pass back.
4. Wire one-time sales to the API. If you sell one-off products, post a server-to-server conversion when a sale succeeds, since Braintree will not send a webhook for it.
5. Set commissions and collect tax forms. Choose your rate and window (20 to 30 percent recurring is common for SaaS), pick a payout method, and gather W-9 or W-8 forms before the first payout.
6. Recruit, then run a refund-aware payout. Invite partners, watch commissions build, reconcile refunds against Braintree, then pay.

If you want the groundwork behind commission rates and recruiting, our guide on how to start a SaaS affiliate program goes deeper on the fundamentals.

Choosing a tool that supports Braintree

When you shortlist tools for Braintree, look past the marketing and check these specifics:

• Native Braintree subscription and dispute webhooks, so recurring commissions and chargeback clawbacks work without you babysitting them.
• A server-to-server API for one-time sales, so non-subscription revenue is not invisible.
• Custom-field attribution with a returning-customer fallback.
• Read-only credential support, so you are not handing over full account access.
• A partner portal and built-in payouts, with tax forms collected at onboarding rather than chased later.

On price, expect the usual shapes: a flat monthly fee, a per-payout percentage, or a take-rate that only applies when affiliates earn. Match the model to your payout volume rather than the headline number.

Common mistakes to avoid on a Braintree affiliate program

Most Braintree affiliate problems trace back to the same short list of oversights:

• Assuming one-time sales track themselves. They will not, because Braintree sends no webhook for them. Wire them to your tool’s API before launch, or those commissions silently never appear.
• Forgetting the refund step. Voluntary card refunds are invisible to webhooks, so a program with no reconciliation slowly overpays. Make the monthly refund check part of payouts.
• Handing over full-access keys. Use a read-only user instead, so a leaked key cannot move money or change settings.
• Launching without the custom field. If the referral field is not created and set to store and pass back before your first sale, early conversions arrive with no affiliate attached.
• Picking a Stripe-only tool by accident. Several popular tools do not support Braintree at all, so confirm it explicitly instead of discovering the gap after you sign up.
• Paying before reconciling. Run refunds and chargebacks against your commissions first, then release payouts, never the other way around.

Rekomi for Braintree

Rekomi, the affiliate and referral platform we make, connects to Braintree using exactly this approach.

You add Rekomi with a read-only Braintree key pair, paste Rekomi’s webhook URL into your Control Panel, and create a rekomi_ref custom field. Rekomi then tracks recurring subscription commissions automatically, reverses them when a dispute is lost, and reads the referral from that custom field, with a returning-customer fallback when it is missing. For one-time sales, where Braintree sends nothing, you post them to Rekomi’s server-to-server API, the same signed endpoint used for custom checkouts.

Affiliate payouts run on Rekomi’s Stripe Express rail, with PayPal rolling out, and Rekomi collects and files affiliate tax forms (W-9, W-8BEN, and W-8BEN-E) so year-end is handled. Pricing is a flat base of $19/mo, $39/mo, or $99/mo (Enterprise is custom), plus a 3 percent take charged only on commissions affiliates actually earn, or 2.5 percent on Enterprise. Payouts and tax handling are included, and the first 14 days are free.

Keep in mind that the Braintree limits apply to Rekomi as they do to any tool: one-time card sales come through the server-to-server API, and one-time card refunds are reconciled by hand, while chargebacks reverse on their own. A workspace also tracks one processor at a time, so you connect Braintree, Stripe, or Paddle, not several at once.

Run your Braintree affiliate program on Rekomi

Rekomi reads your Braintree subscriptions, claws back chargebacks, takes one-time sales over its API, and pays your affiliates for you. Connect a read-only key and have it running this week.

Frequently asked questions

Does Braintree have an affiliate program?

Braintree has no native affiliate feature. Its partner program is for platforms that embed Braintree, not for promoting your product. To run your own program you add a third-party affiliate tool on top of your Braintree account.

Why doesn’t my affiliate tool track one-time Braintree sales?

Because Braintree sends no webhook when a one-time card sale succeeds. Track those sales by posting a server-to-server conversion to your tool’s API at the moment the sale completes.

Does Braintree handle affiliate refunds automatically?

Not for voluntary card refunds, since Braintree fires no webhook for them, so you deny those commissions manually. Chargebacks are different: they arrive as dispute webhooks and reverse the commission automatically.

How do I connect Braintree to an affiliate tool?

With read-only API keys, a merchant ID plus a public and private key pair, rather than OAuth. You also paste the tool’s webhook URL into Braintree’s Control Panel and enable the subscription and dispute notifications.

How does Braintree attribute a sale to an affiliate?

You create a custom field in the Control Panel, set it to store and pass back, and stamp the affiliate’s reference onto the sale. Your tool reads that field from the transaction in the subscription webhook, and falls back to matching a returning customer to their original affiliate if the field is missing.

Which affiliate tools work with Braintree?

A short list. FirstPromoter and Post Affiliate Pro support it natively, alongside a few checkout-plus-affiliate platforms and any tool that can ingest conversions over an API. Many modern, Stripe-first tools do not support Braintree at all, so confirm before you commit.

Can affiliates earn on Braintree subscription renewals?

Yes. Braintree’s subscription webhooks let your tool accrue commission on each successful renewal for the window you choose, which is exactly where Braintree’s affiliate support is strongest.

Do I need a read-only Braintree user?

It is the recommended setup. A read-only user can verify the account and parse webhooks, which is everything an affiliate tool needs, while stopping a leaked key from moving money or changing settings. Create one in the Control Panel and mint its keys for the integration.

How much does it cost to run a Braintree affiliate program?

The main costs are your affiliate tool and the commissions you pay. Tools usually run from roughly $19/mo to $99/mo, charged as a flat fee, a per-payout percentage, or a take-rate that only applies when affiliates earn. On top of that sits your commission rate, often 20 to 30 percent for SaaS.

Is Braintree or Stripe better for an affiliate program?

Stripe has broader webhooks and far more tool support, so it needs less manual work. Braintree is a solid choice if you already use it or want PayPal and Venmo as native options, especially for subscription revenue.

The bottom line

Braintree is a capable, PayPal-backed gateway, and it runs an affiliate program well as long as you design around its webhooks: lean on subscriptions, route one-time sales through an API, let chargebacks claw back on their own, and reconcile refunds by hand. Do that, choose a tool that genuinely supports Braintree, and you get a clean, accurate partner channel sitting on top of the payments you already accept.