Connect Paddle Classic 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.
On Paddle Billing? See Set up Paddle Billing with Tolt.
Add the integration
Go to Settings › Integrations and click Add integration.
Select Paddle and click Continue with Paddle.
Open the Paddle Classic tab.
Add your Paddle keys
In Paddle, go to Developer Tools, open the API Authentication tab and copy the Public API key.
Paste it into Add your Paddle Public API key in Tolt, including the
-----BEGIN PUBLIC KEY-----and-----END PUBLIC KEY-----lines.In Paddle, open the Authentication tab and copy your Vendor ID.
Create an API key named
Tolt API Keyand click Generate Key.Paste the Vendor ID and API key into Add your Paddle Vendor ID and API Key in Tolt.
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({
product: 12345,
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 › Events and click Add New Endpoint.
Enter the webhook endpoint shown under Setup your webhooks in Tolt. It looks like
https://api.tolt.io/webhooks/paddle-classic?id=YOUR-ID.Select these events:
Subscription Created
Subscription Updated
Subscription Cancelled
Subscription Payment Success
Subscription Payment Refunded
Payment Succeeded
Payment Refunded
Save the endpoint.
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.