Integrations

How to Launch a Paddle Affiliate Program for Your SaaS

Run an affiliate program on Paddle: net revenue commissions, refund windows, multi-currency sales and a server-side way to report sales. Rally's Paddle support is coming soon.

Tom MyersFounder, Rally
12 min read

If you use Paddle as your merchant of record (MoR), you already have global payments, tax compliance and subscription management handled. When you launch an affiliate program, you find that most affiliate software targets Stripe first, not Paddle.

This creates a real challenge. With an MoR, tax, refunds, currencies and customer data all flow through Paddle. Your affiliate tracking must account for this to give accurate commissions and correct attribution.

Running a Paddle affiliate program is possible. This guide covers the decisions that matter, including how to calculate commissions and when to approve them.

A note on Rally and Paddle. Rally's Paddle integration is coming soon. You cannot connect Paddle to Rally yet. Until then, a Paddle merchant can report sales to Rally through its server-side conversions API. This guide shows that option in a short section. The rest of the guide applies to any affiliate program on Paddle.

In this guide, you will learn:

  • How Paddle's MoR model affects affiliate tracking
  • Which affiliate platforms mention Paddle support
  • Which Paddle events matter for affiliate programs
  • How to choose between gross and net revenue commissions
  • How to handle refunds, multiple currencies and payout timing
  • Common Paddle-specific issues

Why Paddle Users Need Different Affiliate Setup Considerations

Paddle as Merchant of Record: What It Means

When you use Paddle, Paddle is the merchant of record for every transaction. This changes affiliate tracking in several ways.

What Paddle handles:

  • Payment processing
  • Global tax compliance (VAT, GST, sales tax)
  • Customer invoicing and receipts
  • Refunds and chargebacks
  • Regulatory compliance

What this means for your affiliate program:

  • You receive an amount after Paddle's fees and after taxes, not the gross price.
  • You should decide whether commissions use the gross or the net amount.
  • Paddle's refund policies apply, so your refund window is not entirely under your control.
  • Customer data comes through Paddle's API and webhooks.
  • Multi-currency sales need careful handling.

Example. The numbers below are illustrative. They assume a $99 tax-inclusive price, a 19% VAT rate, and a Paddle fee of 5% + $0.50. Check Paddle's current pricing before you use them.

A customer in Germany buys your $99 per month product:

  • Gross sale: $99.00
  • VAT included in $99 ($99 × 19 / 119): $15.81
  • Paddle fee (5% of $99 + $0.50): $5.45
  • Net to you: $77.74

Do you pay affiliates commission on $99 or on $77.74? Net revenue is the more sustainable choice, but you must decide, configure it and tell your affiliates.

Paddle Billing

Paddle Billing is the current Paddle platform. It has a modern API with webhook events, a sandbox for safe testing, and custom_data fields. These are useful for attribution, because you can pass a referral identifier through checkout and receive it again in the webhook.


Paddle vs Stripe: Affiliate Tracking Differences

AspectStripePaddle
Payment handlingYou are the merchantPaddle is the merchant
Tax handlingYour responsibility (or a tax add-on)Paddle handles it
Webhook eventsStripe events (checkout.*, invoice.*, customer.*)Paddle events (transaction.*, subscription.*, adjustment.*)
Refund handlingYou control itPaddle's policies apply
Commission baseOften the gross priceBetter to use net revenue
Payout to youPer your Stripe settingsPaddle pays on its own schedule

Why the differences matter:

  1. Commission base: Decide whether commissions use gross or net revenue.
  2. Refund windows: Paddle's refund rules may delay when a commission is safe to pay.
  3. Taxes: VAT and other taxes mean that equal prices give different net revenue in different regions.
  4. Currency: Decide whether to pay commissions in one currency or in the sale currency.
  5. Events: Paddle's webhook events have different names and shapes than Stripe's.

Affiliate Platforms That Mention Paddle

Not every affiliate platform supports Paddle. This is the landscape at the time of writing. Verify each claim on the vendor's own site, because integrations change.

  • Rewardful: lists Paddle support. Check which Paddle version and features it covers.
  • Tolt: positions itself around Stripe and Paddle.
  • Reditus: lists Paddle support and focuses on B2B SaaS.
  • FirstPromoter: lists a Paddle integration. Check what setup it needs.
  • Rally: Paddle support is coming soon. Rally supports Stripe today, and a Paddle merchant can report sales with the server-side conversions API in the meantime.

What to look for:

  • Support for Paddle Billing webhooks, not only Paddle Classic
  • A choice between net and gross commission amounts
  • Multi-currency handling
  • A sandbox testing path
  • Refund and chargeback handling
  • Trial-to-paid conversion tracking

Setting Up a Paddle Affiliate Program

The steps below apply to any affiliate system. The Rally-specific part is in the next section.

Step 1: Prepare Your Paddle Account

Start in Paddle's Sandbox environment. Sandbox credentials are separate from production credentials. Generate sandbox API keys and test with sandbox transactions, which use no real money. Switch to production only after the tests pass.

For any integration that reads Paddle data, create an API key with the least permissions it needs, for example read access to transactions, subscriptions and customers. Paddle shows the key once, so store it safely.

You also need a notification destination (a webhook endpoint) in Paddle. Keep the signature secret for that destination, because your server must verify every webhook.

Step 2: Know the Paddle Events That Matter

These are the events that most affect an affiliate program:

EventWhen it firesAffiliate use
transaction.completedA payment is completedCreate a commission for the sale
subscription.createdA new subscription startsTrack the new subscription
subscription.updatedA plan changesAdjust later commissions
subscription.pausedA subscription pausesHold future commissions
subscription.canceledA subscription endsStop future commissions
adjustment.createdA refund or chargeback is recordedReverse the commission

Event names and payload fields can change. Check Paddle's current API reference before you build on them.

Step 3: Decide Your Commission Logic

Option 1: Gross revenue. The commission uses the full sale price. At 20%, a $99 sale gives $19.80. It is easy to explain. But you may pay more than your margin supports after taxes and fees.

Option 2: Net revenue (recommended). The commission uses what you actually receive. At 20%, a $99 sale with $77.74 net gives $15.55. It is sustainable and matches your real margin. The cost is that it is harder to explain to affiliates.

A good affiliate page explains this in plain words:

Commission: 20% of net revenue (after payment fees and applicable taxes).

Example:
- $99 sale in the US: about $93 net = $18.60 commission
- $99 sale in the EU: about $78 net = $15.60 commission (after VAT)

You earn 20% of what we earn.

The numbers in this example are illustrative. Use your own figures.

Why net matters. At 20% of the gross price, the commission is $19.80. On net revenue of $77.74, that equals about 25.5% of net ($19.80 / $77.74). Your effective commission rate is higher than the 20% you advertised. With a net-revenue commission of $15.55, you keep $62.19, which is 80% of net. With a gross commission of $19.80, you keep $57.94, which is about 74.5% of net.

Step 4: Carry Attribution Through Paddle Checkout

Every Paddle affiliate setup relies on one idea: put a referral identifier into the checkout, and read it again in the webhook. Paddle passes custom_data from checkout to the transaction.

Here is an illustrative example. It is a generic sketch, not a Rally integration. It passes a visitor identifier from a tracking script into Paddle.js:

// Illustrative sketch (browser). Field names are examples.
const attribution = window.Rally ? window.Rally.getAttribution() : null;

Paddle.Checkout.open({
  items: [{ priceId: 'pri_plan99', quantity: 1 }],
  customData: {
    referral_visitor_id: attribution ? attribution.visitor_id : '',
  },
  customer: { email: userEmail },
});

Overlay and inline checkout both accept customData in the same way. The tracking script must run on the same hostname where checkout starts, because the cookie is host-only.

Why custom_data helps. It lets you link a transaction to a referral even if the customer uses a different email at checkout.


Report Paddle Sales to Rally (Until Paddle Support Ships)

Rally's Paddle integration is coming soon. Until it ships, you can send each Paddle sale to Rally from your own server with the server-side conversions API.

What you need:

  • A Rally campaign (the program ID) and an API key
  • The Rally tracking script on your site, so that you can capture the visitor ID
  • A small webhook handler on your server that listens for Paddle events

Step 1: Install the Rally tracker.

<script src="https://api.refhero.io/tracker.js" data-program="YOUR_PROGRAM_ID"></script>

Step 2: Pass the visitor ID into Paddle checkout with customData, as in the sketch above.

Step 3: Report the conversion from your server. When Paddle sends a completed transaction to your webhook handler, post it to Rally:

curl -X POST https://api.refhero.io/api/v1/track/conversion \
  -H "X-API-Key: $RALLY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"program_id": "YOUR_PROGRAM_ID", "external_id": "txn_01example", "amount": 99, "currency": "USD", "visitor_id": "VISITOR_ID_FROM_TRACKER"}'

Required fields:

  • program_id
  • external_id: a unique ID for the sale, such as the Paddle transaction ID
  • amount: in major units (99 means $99.00), greater than zero
  • currency
  • one of visitor_id, affiliate_id or coupon_code

Optional fields: external_subscription_id, customer_id, customer_email, and type (initial, recurring, upgrade or downgrade).

A repeated external_id answers 409, so a retried Paddle webhook cannot create a second commission.

Renewals need your own lifecycle checks. Rally does not read Paddle events by itself yet. You report each sale yourself. For a subscription, save the affiliate ID returned by the first successful conversion against your customer on your server. Send each eligible renewal as its own conversion with that affiliate_id, customer_email, and type: "recurring". A visitor_id lookup expires at the campaign cookie window, so do not reuse it for later renewals.

The API calculates a commission for each submitted sale; it does not enforce recurring eligibility or the campaign's recurring term. Your handler must stop reporting commissionable renewals when your promised term ends, the customer cancels, or the original sale is denied or refunded.

Refunds need manual reconciliation. Rally's automatic reversal of commissions on Paddle refunds and chargebacks is part of the coming Paddle support. Until then, review refunded Paddle sales yourself. You can deny a matching sale only while it is pending. Rally has no manual reversal for an approved or paid API sale: reconcile that amount and any recovery outside Rally, and keep a record. Wait past your refund window before approval to reduce this risk.

Choose the amount that fits your commission basis. If you pay on net revenue, send the net amount.

See the docs for the full API reference.


Paddle-Specific Considerations

Merchant of Record Implications

Refunds are not fully under your control. Paddle applies its own refund policies. Customers may be able to request refunds in a window that you did not set. So do not pay a commission the moment a sale happens.

A practical approach: keep commissions pending until your refund window has passed, then approve them. In Rally, every commission starts pending and you approve it in bulk or one at a time. A window of 30 to 45 days is a common choice, but match it to your own refund policy and your Paddle payout timing.

Chargebacks. Paddle handles chargebacks, and you bear the cost. Reverse the matching commission when one occurs. If one affiliate's referrals produce several chargebacks, look at that affiliate's traffic.

Customer data. You do not own the payment records. Keep the Paddle customer ID and transaction ID next to each conversion, so that you can reconcile later.

Multi-Currency and Global Sales

Paddle sells in many currencies. Suppose you have region-specific prices:

  • US: $99 per month
  • EU: 89 EUR per month
  • UK: 79 GBP per month

You have two options for commissions:

OptionHow it worksProsCons
Convert to one currencyPay all commissions in USDSimple accountingExchange rates move
Pay in sale currencyAffiliates earn in the transaction currencyAccurateNeeds payouts in several currencies

Rally stores amounts per currency and creates payouts per currency, so it fits the second option. If you convert to one currency, convert at the time of the sale, not at payout, and write the rule on your affiliate page.

Example policy (illustrative numbers):

All commissions are paid in USD. For sales in other currencies, we use
the exchange rate at the time of the sale.

Example: a sale of 89 EUR converts to $96.50 at the time of sale.
Commission: 20% of $96.50 = $19.30.

Payout Timing

Paddle pays you on its own schedule. Do not pay affiliates before you have received the money.

An example timeline (adjust to your own terms):

  • Day 0: the sale completes and the commission is pending.
  • Days 0 to 30: Paddle's refund window.
  • Day 45: you approve the commission, if the sale was not refunded.
  • After approval: you create the payout and pay the affiliate.

Rally records payouts but does not send money. You pay the affiliate with PayPal, Wise or another method, then mark the payout as sent.

Subscription Billing Details

Trials. With a trial, a subscription exists before the first payment. Pay commission on the first completed payment, not on the subscription start.

Upgrades. When a customer upgrades mid-cycle, Paddle charges the prorated difference. A later commission should reflect the new plan price.

Downgrades. A downgrade usually takes effect at the next renewal, with no transaction until then. The commission changes at that renewal.

Pause and cancel.

ActionWhat happensCommission handling
PausedNo payments during the pausePause commissions, do not claw back
CanceledThe subscription endsStop future commissions

Common Paddle Affiliate Setup Issues

Sandbox and Production Mismatch

Symptoms: The flow works in the sandbox and fails in production, or the reverse.

Cause: Sandbox keys or webhooks are mixed with production ones.

Fix:

  1. Check which environment the Paddle dashboard shows.
  2. Check that the API key and the webhook destination belong to the same environment.
  3. Do not reuse keys or destinations across environments.

Webhook Signature Failures

Symptoms: Paddle sends webhooks, but your server rejects them.

Cause: The signature secret does not match.

Fix: Copy the signature secret from the notification destination in Paddle and store it on your server. Verify every webhook with Paddle's SDK or its documented method before you trust the payload.

Missing Attribution

Symptoms: Sales happen, but no referral data appears in custom_data.

Checklist:

  • Is the tracking script on the page where the visitor landed?
  • Did the checkout start on the same hostname as the tracker (the cookie is host-only)?
  • Does your code read the visitor ID before it calls Paddle.Checkout.open?
  • Does the Paddle transaction show your custom_data fields?

Currency Confusion

Symptoms: Commission amounts look wrong for non-USD sales.

Check:

  1. Which currency is the transaction in?
  2. Did you send the amount in major units (89.00, not 8900)? Paddle sends amounts in the smallest unit, as strings.
  3. Did you send the right currency code? Some currencies, such as JPY, have no minor unit.

Best Practices for Paddle Affiliate Programs

Use Net Revenue as the Commission Basis

Paddle deducts taxes and its own fee. A commission on gross revenue shrinks your margin. Use net revenue and explain it clearly.

Keep Commissions Pending Past the Refund Window

Do not approve commissions until the refund window has passed. This protects you from paying for refunded sales.

Document Tax Handling for Affiliates

Affiliates will ask why a commission is lower on a European sale. A short explanation prevents support work:

## How commissions are calculated

We use Paddle as our merchant of record. Paddle collects taxes and takes
its fee before we receive the money.

1. A customer buys a $99 per month plan.
2. Paddle deducts tax and its fee. We receive the net amount.
3. Your commission is 20% of the net amount.

Net revenue is lower in regions with higher tax, so the commission
on the same $99 plan is lower there too.

Reconcile Monthly

Even with automation, check once a month:

  • Export the month's transactions from the Paddle dashboard.
  • Export the conversions from your affiliate platform.
  • Match transaction IDs.
  • Spot-check 10 to 20 commissions for the right amount.
  • Review refunds and chargebacks that did not reverse a commission.

Conclusion

An affiliate program on Paddle needs a few decisions that a Stripe program does not. Use net revenue as the basis, keep commissions pending past Paddle's refund window, and be clear about currency and taxes.

Key points:

  1. Base commissions on net revenue, not gross.
  2. Keep commissions pending until the refund window passes.
  3. Explain multi-currency and tax effects to affiliates.
  4. Test in the sandbox before you go live.
  5. Reconcile monthly against the Paddle dashboard.

Rally and Paddle. Paddle support in Rally is coming soon. Until then, you can use the server-side conversions API to report Paddle sales. If you also sell through Stripe, Rally's Stripe integration works today. Read the Stripe setup guide for that path, the docs for the API, or see pricing.


Related Resources:

All posts