Set up LemonSqueezy integration with API keys and webhooks for seamless conversion tracking.
LemonSqueezy is a popular payment platform for digital products and SaaS. To connect it with Icodrip, you need a LemonSqueezy store with at least one product and an API key generated from your LemonSqueezy settings.
Navigate to your LemonSqueezy dashboard and go to Settings > API. Create a new API key with read permissions. You do not need write permissions since Icodrip only reads transaction data from webhook events.
Make sure your LemonSqueezy store is on a plan that supports webhooks. All paid plans include webhook support, but the free plan may have limitations. Check your current plan in LemonSqueezy billing settings.
In Icodrip, go to Settings > Integrations and select "Connect LemonSqueezy." Paste your LemonSqueezy API key into the configuration form. Icodrip validates the key by making a test request to the LemonSqueezy API.
If the validation succeeds, you will see your store name and store ID confirmed in the interface. This confirms that Icodrip can communicate with your LemonSqueezy account. The API key is stored encrypted and is never exposed to the client.
You can update or rotate your API key at any time without disrupting active tracking. Simply generate a new key in LemonSqueezy, update it in Icodrip, and revoke the old one.
Copy the webhook URL from Icodrip's integration page. In your LemonSqueezy dashboard, go to Settings > Webhooks and create a new webhook. Paste the Icodrip URL and select the following events: order_created, subscription_created, subscription_updated, and subscription_payment_success.
LemonSqueezy uses a signing secret to verify webhook authenticity. When creating the webhook, LemonSqueezy generates a signing secret — copy this value and paste it into the corresponding field in Icodrip's integration settings.
Icodrip verifies every incoming webhook using HMAC-SHA256 signature validation. If the signature does not match, the event is rejected. This prevents spoofed events from creating false conversions.
LemonSqueezy provides a test mode for each product. Enable test mode on one of your products, generate a tracking link for a test affiliate, and complete a test purchase. The flow should work identically to a production purchase.
After the test purchase completes, check your Icodrip dashboard for the new conversion. It should show the order amount, the calculated commission, and the attributed affiliate. The conversion status will be "pending" until the refund window passes.
If the conversion does not appear, check the webhook logs in both LemonSqueezy and Icodrip. LemonSqueezy shows the delivery status and response code for each webhook attempt. A 200 response means Icodrip received the event successfully. If you see a non-200 response, the error details will help diagnose the issue.