All Collections
Developer
How to set up Paddle with Tolt
How to set up Paddle with Tolt
Learn how to set up Tolt with your Paddle account and SaaS. We made sure it only takes 15 minutes from start to finish!
Valentin avatar
Written by Valentin
Updated over a week ago

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

Did this answer your question?