Integrations
Paddle Integration
Connect Paddle to automatically attribute sales to your affiliates. When a referred customer completes a purchase, AFFY creates the commission for you — no manual work required.
Before you start, make sure you have:
- Installed the AFFY tracking script on the same domain as your Paddle checkout
- Created at least one commission flow — AFFY needs a flow to calculate the commission amount when a sale arrives
Setting up the integration
Copy your webhook URL from AFFY
Go to Settings → Integration in your AFFY dashboard. Find the Paddle section and copy the webhook URL shown there.
Add the webhook in Paddle
Log in to your Paddle dashboard and go to Developer Tools → Notifications. Click New destination and fill in:
- URL: paste the webhook URL you copied from AFFY
- Events to send: select
transaction.completed,transaction.refunded,subscription.created, andsubscription.canceled
Enter the secret in AFFY
Back in AFFY → Settings → Integration, paste the secret key into the Paddle Webhook Secret field and click Save.
The secret key lets AFFY verify that incoming events genuinely come from Paddle. Without it, AFFY will reject all webhook events.
What gets tracked automatically
| Paddle Event | What AFFY does |
|---|---|
| transaction.completed | Creates a commission for the referred affiliate |
| subscription.created | Creates a commission for the initial subscription payment |
| transaction.refunded | Marks the related commission as Refunded |
| subscription.canceled | No commission action — cancellation is logged for reporting |
How refunds are handled
When a refund is issued in Paddle, AFFY automatically marks the related commission as Refunded and removes it from the payout queue.
Full refund
The entire commission is reversed.
Partial refund
The commission is reduced proportionally to the refunded amount.
Refund after payout
Commission is still marked Refunded — you'll need to reconcile with the affiliate manually.