Lemon Squeezy integration

Connect the store where your AI product earns revenue.

Verify a Lemon Squeezy API key, then choose the exact store that belongs to this product. Grow or Die keeps that revenue ledger separate from the subscription payment for Grow or Die itself.

Connect Lemon Squeezy

What it reads

Store-scoped orders, renewals and customers

  • The stores available to the connected account, so you can choose one.
  • Paid, partially refunded, and refunded order facts for that store.
  • Eligible renewal records from subscription-invoices. Initial subscription invoices are excluded so the initial order is not counted twice; invoices with an unknown billing reason are not assumed to be renewals.
  • Customer identifiers and USD order totals needed for the revenue ledger.
  • Pagination and refund-timing coverage needed to decide whether profit is safe to show.

What it does not do

The connector only performs reads

  • No creating checkouts, changing subscriptions, or issuing refunds.
  • No combining orders from stores you did not select.
  • No treating unavailable payment-processor fees as zero.

Lemon Squeezy API keys are not provider-restricted read-only keys. Grow or Die nevertheless uses the connected key only for the documented verification and read requests.

How to connect

Choose the API mode and exact store

  1. Create an API key under Lemon Squeezy Settings → API.
  2. Use a test-mode key for test data or a live-mode key for production revenue.
  3. Paste the key into Grow or Die and let the verification request list its stores.
  4. Select the one store whose revenue belongs to the connected website.

The key is encrypted at rest and never returned to the browser. You can disconnect it from Grow or Die and revoke it in Lemon Squeezy at any time.

What it unlocks

Observed revenue before unavailable processor fees

Paid and refund-adjusted orders and eligible renewal invoices supply revenue and revenue per visitor. When a Lemon customer ID and server-side model usage map to the same product account, the ledger can support customer-level contribution profit.

Current limits

Refund timing and coverage stay explicit

Provider refund time is used when available. Otherwise an order's updated_at or original order time is a fallback, not proof of the exact refund event time. The connector reads API snapshots; it does not implement a dedicated merchant refund webhook ledger. Approximate timing and bounded or truncated imports limit contribution decisions. Processor fees remain unavailable. See the shared revenue-basis guide.

Example: revenue is not the payout

Synthetic USD example: a provider-reported $24 order includes $4 tax, leaving $20 before processor fees. A half refund of $12 includes $2 tax, reducing that amount by $10 to $10. Processor fees remain unknown, not $0. A separate eligible $24 renewal with $4 tax adds $20 in its own reporting window; its initial invoice must not be added again.

The connector uses provider-reported USD amounts, not today’s foreign-exchange rate. Approximate refund timing or an incomplete import remains a coverage limitation. This example is not a customer result or a claim about net profit.

Primary source

Create and protect the API key

Follow Lemon Squeezy’s official API getting-started guide .