Affiliate platforms: questions to ask before you migrate (SaaS)
A practical checklist for migrating affiliate platforms in SaaS: what to export, how to compare ledgers, how to handle refunds and clawbacks, and the safest cutover plan.
Read articleOpsMar 14, 2026
Affiliate dashboard: how to explain attribution (so you get fewer disputes)
If partners don’t understand the rules, they’ll email you during payouts
Most affiliate disputes are not fraud. They are confusion. If your dashboard shows a total number without showing the rule that produced it, partners will assume the system is wrong — especially when coupons, refunds, or multiple clicks exist.
This post gives you a simple dashboard spec to explain attribution in plain language: what credit means, why something is pending, and what happens on refunds. The goal is boring payouts.
Table of contents
- The 3 questions your dashboard must answer
- Where attribution confusion comes from
- The minimum attribution panel (copy/paste)
- Pending vs approved vs paid (status rules)
- Coupon vs link conflicts (explain it once)
- Refunds and clawbacks (microcopy)
- Related pages
The 3 questions your dashboard must answer
- What got tracked (click or coupon)?
- What counts as a conversion (and when)?
- When is money ‘real’ (pending vs approved vs paid)?
If you answer these three questions clearly, most support tickets disappear. If you do not, you will keep getting the same email: ‘I sent you a customer but it didn’t show up.’
Where attribution confusion comes from
- A customer clicks an affiliate link on one device, then purchases on another
- A coupon is used without a recorded click
- A customer clicks multiple affiliates before buying (who gets credit?)
- A refund happens after the conversion appears in the dashboard
You cannot prevent all of this. What you can prevent is ambiguity: write one clear rule and show it inside the dashboard.
The minimum attribution panel (copy/paste)
Add a small ‘How credit works’ panel near the earnings table. Use plain language and make it visible without scrolling.
- Attribution window: Last affiliate link click within 30 days before purchase.
- Coupon fallback: If a coupon code is used, credit goes to the coupon owner unless another affiliate link click happened within the last 24 hours.
- Conversion: Commission is created when the first paid invoice is recorded.
Pending vs approved vs paid (status rules)
| Status | What it means | Why it exists |
|---|---|---|
| Pending | Tracked, but not payable yet | Protects against refunds/chargebacks |
| Approved | Payable in the next payout cycle | It’s past the refund window / reviewed |
| Paid | Included in a completed payout | So partners can reconcile payments |
If you don’t show statuses, partners assume the number is final. That’s how refunds turn into arguments.
Coupon vs link conflicts (explain it once)
If your program allows coupons, you must publish a conflict rule. Put the exact rule in the dashboard so affiliates don’t have to search your terms.
Example microcopy: ‘If a coupon is used, we attribute the conversion to the coupon owner — unless a different affiliate link click happened in the last 24 hours.’
Refunds and clawbacks (microcopy)
- Refunds: If a purchase is refunded or charged back, the related commission is canceled.
- If a commission was already paid, we deduct it from a future payout (shown as an adjustment).
The key is to show adjustments as line items. Hidden clawbacks feel like theft even when they are fair.
FAQ:
Why did my click show up but not my commission?
Usually because a click is not a conversion. A commission is created only when your defined conversion event happens (for example: first paid invoice). Also: last-click rules and coupon conflicts can change which partner gets credit.
Why is my commission pending?
Pending means it was tracked but isn’t payable yet. Most programs keep commissions pending until payment settles and the refund window passes.
What should the dashboard show for every line item?
Date, status, amount, and the attribution signal (link click vs coupon). If you can’t reconcile line items, disputes become inevitable.
Related pages
Want this Playbook in your inbox?
I share practical notes on affiliate programs for SaaS.No spam. No hype.
Unsubscribe anytime. No spam.
Ready to launch?
If Rewardful feels like overkill, start simple: signup page + links + Stripe-attributed revenue.
Related posts
Affiliate tracking for subscriptions: what changes vs one-time sales (a practical guide)
A founder-friendly guide to affiliate tracking for SaaS subscriptions: which event earns commission, how to handle trials and plan changes, how recurring commissions work, and the tests that catch broken attribution.
Read article