Connect Lemon Squeezy
Send your Lemon Squeezy orders, renewals and refunds to Clakta over a webhook, and credit each sale to the visitor who made it.
Lemon Squeezy sends your sales, renewals and refunds to Clakta through a webhook that you create once in Lemon Squeezy. Clakta gives you the URL and the signing secret, and you paste both there.
Connect
- Go to Project settings → Sales platforms.
- Choose Lemon Squeezy, name the connection, and click Create connection. Clakta generates a webhook URL and a signing secret. Copy both.
- In Lemon Squeezy, go to Settings → Webhooks and click +.
- Paste the URL, paste the signing secret into the Signing secret field.
- Select the four events in the table below.
| Event | What it does in Clakta |
|---|---|
order_created | Records the sale. |
order_refunded | Marks the order refunded. |
subscription_payment_success | Records each subscription renewal. |
subscription_payment_refunded | Marks a refunded renewal. |
- Save the webhook in Lemon Squeezy, then click Finish in Clakta.
The connection is ready as soon as you create it (the card reads Added right away), and sales start arriving once the webhook is saved in Lemon Squeezy.
It is stored encrypted and can't be displayed again, so copy it before you close the dialog. If you lose it, open the connection and click Generate new signing secret, then paste the new value into the webhook in Lemon Squeezy. The old secret stops working as soon as you generate a new one.
Lemon Squeezy keeps test-mode and live-mode webhooks apart, and a webhook only ever receives events from the mode it was created in. Create the connection in the mode whose sales you want in Clakta, and if you test first, create a second connection when you go live.
A subscription renewal fires no order_created at all: Lemon Squeezy reports
it as an invoice instead. Without subscription_payment_success, your first
month is recorded and every renewal after it is invisible.
Selecting extra events is harmless: anything Clakta does not handle is acknowledged and ignored.
Turn on the Clakta script
To credit each sale to the visit that brought it, install the Clakta script on the pages that link to your Lemon Squeezy checkout. The script adds the visitor's session to the checkout on its own, so there is nothing else to set up. Projects in privacy-friendly mode don't send this session.
If you build the checkout in your own code
If you create checkouts through the Lemon Squeezy API, pass the session yourself:
If you open overlays yourself, decorate the URL first:
Troubleshooting
Related articles
Connect Shopify
Install the Clakta app on your Shopify store. It sets up checkout tracking, imports your recent orders and matches each sale to the ad that produced it.
Connect Dodo Payments
Point Dodo Payments at Clakta with a webhook so your payments, refunds and chargebacks arrive automatically, and each sale is matched to the visitor who made it.
Connect Paddle
Send your Paddle sales, renewals and refunds to Clakta over a webhook, and credit each sale to the visitor who made it.