Connect Paddle Billing so Tolt can track the customers your partners refer and the payments they make. You add your Paddle keys, add Tolt's tracking script to your site, send each customer's referral ID to Paddle and set up a webhook.
Still on Paddle Classic? See Set up Paddle Classic with Tolt.
Add the integration
Go to Settings › Integrations and click Add integration.
Select Paddle and click Continue with Paddle.
Open the Paddle Billing tab.
Add your Paddle API key
In Paddle, go to Developer Tools › Authentication › API keys.
Create a server-side API key, or copy an existing one, with these permissions:
Adjustments: Read
Customers: Read
Discounts: Read & Write
Products: Read
Subscriptions: Read
Transactions: Read
Notifications: Read
Paste the key into Add your Paddle API key in Tolt.
Note: Client-side tokens don't work for this integration. Use a server-side API key.
Add the tracking script
Copy the script from Add the Tolt tracking script to your site and paste it into your website's <head> tag. Add it to every page where you want to track referrals, such as your landing pages and app.
Send the referral ID to Paddle
The script stores the visitor's referral ID in window.tolt_referral. Send it to Paddle as tolt_referral in customData when you open the checkout.
This JavaScript example uses Paddle.js:
Paddle.Checkout.open({
items: [{
priceId: "pri_123",
}],
email: "[email protected]",
customData: {
tolt_referral: window.tolt_referral,
},
});
Without Paddle.js, the idea is the same: pass window.tolt_referral to the checkout in customData.
Set up the webhook
In Paddle, go to Developer Tools › Notifications and add a new destination.
Enter the webhook endpoint shown under Setup your webhooks in Tolt. It looks like
https://api.tolt.io/webhooks/paddle-billing?id=YOUR-ID.Select these events:
subscription.createdsubscription.cancelledtransaction.completedadjustment.createdadjustment.updateddiscount.updated
Save the destination. Then open its action menu (⋮), select Edit destination and copy the webhook secret.
Paste the secret into Add your Paddle Webhook secret in Tolt.
Save the integration
Optionally, under Extra, switch on Exclude Paddle fee in the tracking amount or Exclude Paddle tax in the tracking amount to calculate commissions without them.
Click Save integration.
Tolt now tracks payments from the customers your partners refer.
Good to know
For developers: the Paddle integration guide in Tolt's API docs covers the same setup in more detail, including refunds.
To record customers when they sign up, before they pay, see Track sign-ups as leads.
To check that everything works, see Test the integration.
Need a hand? Contact us via chat and we'll set up Paddle with you.