Trackli
Use Case|Paddle Billing

Affiliate Tracking for Paddle Billing (v2 API)

Paddle Billing (v2) introduces a modern API with improved subscription management, customer portals, and checkout experiences. Trackli fully supports the new Paddle Billing API, giving you accurate affiliate tracking that leverages the latest Paddle platform capabilities.

How to Set Up Paddle Billing Affiliate Tracking

Get up and running in minutes with these simple steps.

1

Connect Paddle Billing API

Generate a Paddle Billing API key and enter it in Trackli. We verify the connection and import your product catalog from the new API format.

2

Configure Notification Destinations

In Paddle Billing, create a notification destination pointing to Trackli. Subscribe to transaction.completed, subscription.created, and related events.

3

Set Revenue-Based Commissions

Paddle Billing provides clearer revenue breakdowns. Trackli uses the earnings amount (your payout) for commission calculations, not the gross transaction.

4

Handle Price Overrides and Custom Pricing

Paddle Billing supports price overrides for specific customers. Trackli tracks the actual charged amount for commission regardless of catalog pricing.

5

Test with Sandbox Environment

Use Paddle Billing's sandbox environment to test the complete affiliate flow. Trackli processes sandbox notifications the same as production.

How It Works

From referral link to commission payout — fully automated with Paddle Billing.

Affiliate tracking flow diagram for Paddle Billing

Trackli vs Traditional Affiliate Tracking

See how Trackli compares to manual or legacy affiliate solutions.

FeatureTrackliTraditional
Paddle Billing v2 Native SupportBuilt for Paddle's modern API and event systemLegacy Paddle Classic integration only
Earnings-Based CommissionsUses Paddle's earnings amount for accurate payout-based commissionTransaction total used, ignoring Paddle's fees
Customer Portal IntegrationTracks plan changes made through Paddle's customer portalOnly tracks changes made through your app
Price Override HandlingCommissions on actual charged amount including overridesCatalog price assumption regardless of overrides
Notification ReliabilityHandles Paddle Billing's notification retry and verificationNo notification verification or retry handling
Sandbox TestingFull testing support with Paddle's sandbox environmentLive-only testing with real transactions

Frequently Asked Questions

What's different about Paddle Billing vs Paddle Classic?
Paddle Billing (v2) has a redesigned API, improved subscription management, a customer portal, and clearer revenue reporting. Trackli supports both, but Paddle Billing offers better data for commission calculations.
How does Trackli use Paddle Billing's earnings data?
Paddle Billing separates transaction totals from your actual earnings (after Paddle's fees and taxes). Trackli uses the earnings amount for commission calculations, ensuring you pay commissions only on revenue you actually receive.
What if a customer changes their plan through Paddle's portal?
Paddle Billing's customer portal lets customers self-manage their subscriptions. Trackli receives notification events for all portal actions (upgrades, downgrades, cancellations) and adjusts commissions accordingly.
Can I test affiliate tracking with Paddle's sandbox?
Yes. Paddle Billing provides a sandbox environment for testing. Trackli processes sandbox notifications identically to production, so you can validate the complete affiliate flow without processing real payments.
Should I migrate from Paddle Classic to Paddle Billing?
If you're starting new, use Paddle Billing. If you're on Paddle Classic, consider migrating for better APIs and features. Trackli supports both versions, so your affiliate tracking works regardless of which Paddle version you use.

Ready to launch your affiliate program?

Start tracking affiliate referrals in minutes. No complex setup, no enterprise pricing.