Connect Paddle Billing so Tolt can credit partners for the customers they refer. You add a Paddle API key, add the tracking script to your site, pass each visitor's referral to Paddle at checkout and add a webhook.
Still on Paddle Classic? See Set up Paddle Classic with Tolt.
Connect Paddle
Go to Settings › Integrations, click Add integration and choose Paddle.
Make sure the Paddle Billing tab is selected.
In Paddle, go to Developer Tools › Authentication › API keys and create a server-side API key with these permissions:
Adjustments: Read
Customers: Read
Discounts: Read & Write
Notifications: Read
Products: Read
Subscriptions: Read
Transactions: Read
Paste the key into API key under 1. Connect Paddle Billing.
Use a server-side API key. Client-side tokens don't work for this integration.
Add the tracking script
Under 2. Add the tracking script, copy the script and paste it inside the <head> tag of every page of your website and app. It already includes your public key:
<script
async
src="https://files.tlt-cdn.com/v2/tlt.js"
data-tolt="YOUR_PUBLIC_KEY"
></script>
Use the Next.js or Google Tag Manager tab if your site uses them. On Webflow, Framer or WordPress, paste it into the site-wide head code.
Pass the referral to Paddle
The tracking script stores each referred visitor's referral in window.tolt_referral. Add it to the checkout's customData as tolt_referral:
Paddle.Checkout.open({
items: [{ priceId: "pri_123", quantity: 1 }],
customer: { email: "[email protected]" },
customData: { tolt_referral: window.tolt_referral },
});Creating transactions on your server instead? Send window.tolt_referral from the browser and set custom_data: { tolt_referral } on the transaction.
Add the webhook
In Paddle, go to Developer Tools › Notifications and add a destination with the Webhook URL shown under 4. Add the webhook in Tolt.
Select these events:
subscription.createdsubscription.canceledtransaction.completedadjustment.updateddiscount.updated
Save the destination. Then open its menu (⋮), choose Edit destination and copy the secret key.
Paste it into Webhook secret in Tolt.
Save the integration
Optionally, under 5. Settings, switch on Exclude Paddle fee or Exclude Paddle tax to calculate commissions without them.
Click Save integration.
Tolt now tracks payments, refunds and cancellations from the customers your partners refer. The integration shows under Connected in Settings › Integrations.
Good to know
With Paddle connected, Tolt records payments for you. Don't also send the same payments through Tolt's API, or commissions count twice.
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.
For developers: the Paddle integration guide covers the same setup, including refunds.
Need a hand? Contact us via chat and we'll set up Paddle with you.