Paddle
Paddle Integration
Paddle Billing integration — Track subscriptions, one-time payments, and trials with automatic webhook attribution
Connect Paddle to Icodrip in under 60 seconds. Paste your Paddle API key and configure the webhook URL — that's it. Icodrip captures every Paddle payment event through webhooks and attributes conversions to the referring affiliate automatically. Supports Paddle Billing (v2) and Paddle Classic, including subscription trials, upgrades, downgrades, prorated changes, and refunds. As a merchant of record, Paddle handles global tax compliance, which means your affiliate program works seamlessly across 200+ countries without additional tax configuration. Recurring commissions are calculated automatically on each renewal, and refunds trigger automatic commission reversals to protect your margins.
Key features
Paddle Billing (v2) support
Full compatibility with Paddle's latest billing platform including catalog management, custom pricing, and prorated plan changes.
Merchant of record compatible
Paddle handles global tax, VAT, and sales tax. Your affiliate program works in 200+ countries with no additional tax setup.
Passthrough attribution
Pass referral codes via Paddle's passthrough parameter or custom data fields. Icodrip extracts and matches them automatically on every transaction.
Trial tracking
Track trial starts separately from paid conversions. Commissions are only applied when the trial converts to a paid subscription.
Automatic commission reversals
Refunds and chargebacks from Paddle trigger automatic commission reversals. Affiliate balances update in real-time.
Recurring commission support
Pay affiliates on every subscription renewal, not just the first payment. Track the full customer lifecycle across months or years.
How it works
1
Add Paddle API credentials
Navigate to Icodrip's integration settings and paste your Paddle API key. We support both Paddle Billing (v2) and Classic API formats.
2
Configure webhook URL
Copy the unique webhook URL from your Icodrip dashboard and add it in Paddle under Developer > Notifications. Select all payment and subscription events.
3
Set up attribution
Choose your attribution method: referral cookie matching, passthrough parameter, or custom metadata. Icodrip checks all methods for every transaction.
4
Test and go live
Use Paddle's sandbox environment to verify the integration. Send a test transaction and confirm it appears in your Icodrip dashboard with the correct affiliate attribution.
Events tracked
- transaction.completed — Successful one-time and subscription payments
- subscription.created — New subscription signups
- subscription.updated — Plan upgrades, downgrades, and quantity changes
- subscription.canceled — Subscription cancellations
- subscription.past_due — Failed renewal payments
- adjustment.created — Refunds, credits, and chargebacks
Use cases
SaaS with global customers
Paddle handles tax compliance in 200+ countries. Combined with Icodrip, you run a global affiliate program without worrying about VAT or sales tax on commissions.
Freemium-to-paid conversion tracking
Track when trial users convert to paid plans and attribute the conversion to the affiliate who originally referred them — even weeks after the initial click.
Digital product bundles
Sell software licenses, course bundles, or digital downloads through Paddle. Affiliates earn commissions on each product in the bundle.
Integration examples
Paddle Checkout with referral passthrough
// Pass referral code via Paddle's checkout settings
Paddle.Checkout.open({
items: [{ priceId: 'pri_xxxxx', quantity: 1 }],
customData: {
referral_code: 'AFFILIATE123' // Icodrip picks this up automatically
},
settings: {
successUrl: 'https://yoursite.com/success',
}
});Paddle webhook verification
// Icodrip handles webhook verification automatically.
// If you want to also process Paddle events in your own app:
const webhookUrl = 'https://api.icodrip.com/api/webhooks/paddle';
// Add this URL in Paddle Dashboard > Developer > Notifications
// Icodrip verifies the webhook signature and processes:
// - transaction.completed
// - subscription.created / updated / canceled
// - adjustment.created (refunds)Setup takes less than 60 seconds.
No code changes required.
Frequently asked questions
Related Integrations
Other Payment Processors integrations
Stripe
Official Stripe App — Automatic affiliate tracking via OAuth & webhooks
LemonSqueezy
LemonSqueezy integration — Track digital product sales, subscriptions, and license keys with webhook-based attribution
PayPal
PayPal integration — Track payments, subscriptions, and use PayPal as an affiliate payout method
Learn More
Start tracking with Paddle
Create your free account and connect Paddle in under a minute.