There are a few steps that you have to do to set up your SaaS and Paddle with Tolt.
You can find the integration set up in your Tolt dashboard within Program Settings.
First, you'll need to add your Paddle Public Key:
Then, you'll need to add our tracking script:
<script async src="https://cdn.tolt.io/tolt.js" data-tolt="YOUR-ID"></script>
The script needs to be added on your landing page, or even better, on every page, so we never miss a referral. This script will add a global variable called "tolt" to your window object. The size of the script is around 4KB.
Send Referral ID to Paddle:
You'll need to send a Tolt generated unique ID to Paddle via customData.
Referrals Tolt ID can be received from the script that was added on the previous step. To access the unique ID use window.tolt_referral
You'll need to send the Tolt generated ID to the Checkout when opening.
Example:
Paddle.Checkout.open({
product: 12345,
email: "[email protected]",
customData: { tolt_referral: window.tolt_referral, },
});* Example above is using Paddle.js but the process if the same without it. You will need to send the referral ID that is generated by Tolt's script to the checkout via customData. The referral ID can be accessed by using window.tolt_referral on the client side.
And lastly, Webhook setup:
You'll need to add a new endpoint for Paddle to send webhooks to. This can be done by navigating to "Developer Tools" then "Events" and click on "Add New Endpoint".
Webhook Endpoint:
https://api.tolt.io/webhooks/paddle
Make sure the following webhooks events are selected:
Subscription Created
Subscription Updated
Subscription Cancelled
Subscription Payment Succeeded
Subscription Payment Refunded
Payment Succeeded
Payment Refunded
You can always contact us via live chat and we can set up Paddle together!
Signup a Referral
You can learn more about Paddle x Tolt here: Paddle Affiliate Program with Tolt