Now with MCP · your agent can query commission, affiliates, and payouts. Read-only. Connect a client
← Blog

How to Add an Affiliate Program to Paddle (2026)

Paddle is a merchant of record with no built-in affiliate program. Here's the webhook-based setup that gives Paddle stores recurring affiliate commissions, refunds handled, in about 10 minutes.

SSled5 min read
·Share on X

Paddle is the merchant of record for a huge chunk of indie SaaS: it handles global sales tax, invoicing, and subscriptions so you don't have to. If you sell through Paddle, you picked it to remove operational burden.

Then you go looking for an affiliate program and hit the same wall every Paddle merchant hits: Paddle has no built-in affiliate tracking. There's no referral program, no partner dashboard, nothing in the dashboard settings.

The good news: Paddle's webhook system (Paddle Billing notifications) is clean, signed, and carries everything an affiliate tracker needs, including subscription ids, which is what makes recurring commission possible. This guide walks through the modern setup: one script, one webhook, one checkout parameter, live in about ten minutes.

Paddle, rowing alone in your billing stack, about to get a crew

What you'll have when you're done

  • A public signup page where affiliates join your program (yoursite.com/yourprogram/join)
  • Unique referral links per affiliate (yoursite.com/?ref=abc1234)
  • Automatic attribution when a referred visitor buys through Paddle checkout
  • Recurring commission that follows every subscription renewal, not just the first charge
  • Refund clawback, commissions reverse automatically when a customer refunds
  • A dashboard where you see clicks, conversions, and what's owed per affiliate
  • A private dashboard where each affiliate sees their own numbers

Why Paddle merchants need an external affiliate layer

Three reasons, and they're structural, not accidental:

  1. Paddle is a merchant of record. Your "customer" relationship runs through Paddle's checkout, which means any referral tracking has to live at the layer where you control the page, your marketing site and the checkout creation call.
  2. Paddle Billing webhooks are the single source of truth for paid, renewed, refunded, and canceled events. Any affiliate tool that doesn't consume these webhooks is guessing.
  3. Renewals don't re-carry referral info. When Paddle fires subscription.updated or the next transaction on a renewal, there's no original referrer attached, the tracker has to resolve it from the subscription. Tools built only for first-click attribution on Stripe's checkout.session.completed quietly lose recurring commission here.

The setup, step by step

1. Create your program

Sign up at Sled, pick a slug. You get:

  • A tracking script URL: https://usesled.com/yourslug/t.js
  • A webhook endpoint for Paddle: https://usesled.com/yourslug/api/webhook/paddle
  • A join page: https://usesled.com/yourslug/join

2. Put the tracking script on your marketing site

<script async src="https://usesled.com/yourslug/t.js"></script>

That's the entire client side. When a visitor lands with ?ref=abc1234, the script drops a first-party referral cookie. No pixel army, no third-party trackers, one cookie, hashed IPs, self-referral blocking on by default.

3. Register the webhook in Paddle

In your Paddle dashboard → Developer tools → Notifications, create a notification destination:

URL:     https://usesled.com/yourslug/api/webhook/paddle
Events:  transaction.completed
         adjustment.created
         adjustment.updated
         subscription.canceled

Paste your Paddle notification signing secret into Sled's settings (Settings → Webhooks → Paddle). Sled verifies the Paddle-Signature HMAC on every delivery, so unsigned or badly-signed payloads get rejected outright, this is how you know your commission numbers aren't being fed by anyone with curl.

Wherever you create Paddle checkouts server-side, forward the cookie as custom data:

// read the referral cookie set by t.js
const referral = req.cookies.get("ta_ref")?.value ?? "";

const checkout = await paddle.checkouts.create({
  items: [{ priceId, quantity: 1 }],
  customData: { referral },
});

res.redirect(checkout.url);

Paddle echoes custom_data back in every notification for that transaction and its subscription, that's the thread Sled uses to attribute the sale to the affiliate.

You, five minutes into the setup

5. How the money math works after that

Every transaction.completed notification with a referral becomes a pending commission at whatever rate you set (percentage or fixed). Then the boring-but-critical parts run automatically:

  • Renewals: each new transaction on the same subscription id inherits the original affiliate, so recurring commission pays out every billing cycle without the renewal carrying the referral again.
  • Refunds: Paddle delivers refunds as approved adjustment events (adjustment.created / adjustment.updated with status approved), Sled claws the commission back, including the awkward case where the refund notification arrives before the sale notification. Chargebacks claw back the same way. It reconciles, it doesn't break.
  • Retries: Paddle retries failed deliveries. Every webhook is processed idempotently, so a retried notification never double-counts a commission.
  • Visibility: every delivery shows up in your webhook log with its parsed outcome (ok, recurring, reconciled, duplicate) ignored. No silent drops, ever.

This is the same pipeline Sled runs its own subscription revenue through, and it's why the refund edge cases have a whole post of their own.

Merchant of record specifics worth knowing

  • Tax & invoicing stay Paddle's job. Affiliates don't change your MoR setup; the referral metadata rides along inside Paddle, not beside it.
  • One-time products work too. Not everything on Paddle is a subscription, fixed commissions on one-off purchases are the same webhook, same custom data.
  • Overlays and checkout elements: if you use Paddle's client-side checkout overlay, set customData in the overlay settings object instead of the server call. Same field, same thread.
  • Sandbox: test against a Paddle sandbox environment first, point a second notification destination at Sled and send yourself a test charge. Two minutes, saves one real refund later.

What it costs

A 10-day free trial of the full product, no card needed. After that it's $19/month flat: no percentage of commissions, no per-affiliate fee, no revenue tiers. A Paddle store doing $50K/month through affiliates pays the same $19 as one doing $500. See the full pricing page for what's included.

First webhook, first conversion

After setup: the part everyone skips

The software is the easy 20%. What actually makes a Paddle affiliate program work:

  1. Recruit where your users already are, your best first affiliates are usually customers and newsletter readers. Start with this playbook for your first 10 affiliates.
  2. Set a commission that's worth writing about. For SaaS, 20–30% recurring is the band serious affiliates expect, see the commission rate guide.
  3. Send affiliates a welcome email the day they sign up, with links and one suggested first post. There's a template here.

FAQ

Does Paddle have a built-in affiliate program? No. Paddle handles billing, subscriptions, tax, and checkout as a merchant of record, but affiliate tracking isn't part of it. You add it via webhooks with an external tracker.

Can affiliates get recurring commission on Paddle subscriptions? Yes, as long as your tracker resolves renewals by subscription id. That's how Sled credits renewals automatically, even though Paddle's renewal notifications don't re-send the original referral.

Do refunds reverse the affiliate commission? Automatically. A transaction.refunded notification claws back the pending or paid commission, and out-of-order deliveries are reconciled rather than dropped.

What if I'm also selling through Stripe or Polar? Run them side by side, Sled handles Stripe natively and Polar natively, with one affiliate dashboard across all your stores.


Related: Polar.sh affiliate program guide · Stripe affiliate program guide

Try Sled

Recurring commission on every renewal.

Polar-native affiliate tracking, with Stripe and Paddle handled the same way. 10-day trial, no card required, cancel anytime. Then $19/mo or $99/yr.

Keep reading

All posts →