Start free Open dashboard
Menu

Lemon Squeezy revenue analytics for Astro

This guide adds ProductLense to a Astro site and connects Lemon Squeezy, so every Lemon Squeezy payment is attributed to the channel, campaign and landing page that first brought the customer. It takes four steps and about ten minutes.

1. Add ProductLense to Astro

The script goes in src/layouts/Layout.astro. Replace SITE_ID with the id from Settings → Sites.

src/layouts/Layout.astro
---
const { title } = Astro.props;
---
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <title>{title}</title>
    <script is:inline defer data-site="SITE_ID" src="https://api.productlense.app/a.js"></script>
  </head>
  <body>
    <slot />
  </body>
</html>

2. Identify signed-in users

src/components/ProductLenseIdentify.astro
---
const { userId } = Astro.props;
---
<script is:inline define:vars={{ userId }}>
  window.productlense = window.productlense || function () { (window.productlense.q = window.productlense.q || []).push(arguments); };
  if (userId) window.productlense('identify', userId);
</script>

3. Connect Lemon Squeezy

Setup steps

  1. In Lemon Squeezy, open Settings → API and create an API key. Note the store id under Settings → Stores.
  2. In ProductLense, open Settings → Billing connections → Lemon Squeezy and paste the key and store id.
  3. In Lemon Squeezy → Settings → Webhooks, add a webhook endpoint with the URL ProductLense shows after you save the connection (pattern https://api.productlense.app/api/webhooks/{provider}/{connection_id}).
  4. Choose a signing secret, tick the events listed below, and paste the same secret into ProductLense.
  5. ProductLense backfills 12 months of orders and invoices.

Credentials and permissions

FieldSecretWhere to find it
API keyYes, encrypted at restSettings → API → create API key.
Store IDNoThe numeric store id from Settings → Stores.
Webhook signing secretYes, encrypted at restThe signing secret you set when creating the webhook in Settings → Webhooks.

Webhook

URL pattern, shown with your connection id after you save:

text
https://api.productlense.app/api/webhooks/lemonsqueezy/{connection_id}

Events: order_created, order_refunded, subscription_created, subscription_updated, subscription_cancelled, subscription_payment_success, subscription_payment_refunded, subscription_payment_recovered

Verification: X-Signature header: HMAC-SHA256 of the raw body with your signing secret.

What ProductLense reads

Customers
Customers with email.
Subscriptions
Subscriptions with status. The subscription object has no price, so revenue comes from orders and invoices.
Payments
Orders and subscription invoices.
Refunds
The refunded amount on orders and subscription invoices.
Fees
Not exposed by the Lemon Squeezy API, so recorded as 0. Profit for this connection is before Lemon Squeezy’s fee.

What ProductLense never touches

  • Never creates, changes, refunds or cancels anything: read-only API calls and incoming webhooks only.
  • Never moves money, issues payouts, or reads bank account details.
  • Never sees full card numbers; providers do not expose them.
  • Never sends your customer data to the AI model: Ask and the daily insight see aggregates only.

Match payments to your users

Pass checkout[custom][pl_user_id] in your checkout links to match buyers to visitors by id instead of email.

checkout link
const url = new URL('https://YOUR_STORE.lemonsqueezy.com/checkout/buy/VARIANT_ID');
url.searchParams.set('checkout[email]', user.email);
url.searchParams.set('checkout[custom][pl_user_id]', user.id);

Lemon Squeezy on Astro: questions

Where does the ProductLense script go in Astro?
In src/layouts/Layout.astro. Add the script tag with is:inline to the <head> of your base layout. The script is about 2.3 KB, loads with defer, sets no cookies, and records route changes in single-page apps through the history API, so no extra router code is needed.
How do I identify users in Astro?
Call window.productlense('identify', userId) once the signed-in user is known, as in the src/components/ProductLenseIdentify.astro example on this page. Use the same id you store on Lemon Squeezy as pl_user_id, so Lemon Squeezy payments match by id rather than by email.
Does ProductLense work with Lemon Squeezy?
Yes. ProductLense connects to Lemon Squeezy with aPI key, store ID, webhook signing secret, backfills 12 months of history, and stays current through signed webhooks plus a nightly reconcile. One connection is included on Starter; Growth and Scale allow every provider at once on the same site.
What data does ProductLense read from Lemon Squeezy?
Customers, subscriptions, payments, refunds and fees, read-only. Payments: orders and subscription invoices. Refunds: the refunded amount on orders and subscription invoices. Fees: not exposed by the Lemon Squeezy API, so recorded as 0. Profit for this connection is before Lemon Squeezy’s fee.
Can ProductLense change anything in my Lemon Squeezy account?
No. ProductLense only makes read calls and receives webhooks. It never creates, changes, refunds or cancels anything, never moves money, and never sees card numbers. Credentials are encrypted at rest, and the AI features only ever see aggregated numbers, never your customers’ data.

Free up to 10k events a month. No card.

Add the script, connect Stripe or any of 14 other billing providers, and see revenue by channel the same day.

Start free Read the docs →