Selling on Lemon Squeezy?

Lemon Squeezy licence keys or refunds not behaving? We bring it back.

Lemon Squeezy is the indie and creator friendly merchant of record, built around a quicker setup than Paddle and a developer experience aimed at small SaaS and digital product stores. Most of the trouble we see is in the licence key lifecycle, the refund webhooks and the subscription updater events behaving differently than the docs suggested.

  • Since 2015Fixing technology
  • FreeEstimates
  • US teamReal engineers

lemon-squeezy.log

still failing

What it is

Lemon Squeezy at a glance

Lemon Squeezy is a merchant of record payments platform aimed at indie developers, SaaS founders and digital creators. It launched in 2021 by JR Farr and was acquired by Stripe in July 2024, though it continues to operate as a separate product with its own API and dashboard.

Like Paddle, it handles sales tax, VAT and chargebacks as the legal seller of record, but it positions itself specifically for smaller teams: faster onboarding, included hosted checkout pages, a licence key system for selling software activations, and affiliate tracking built in. The product supports subscriptions, one off purchases, bundled discounts and digital file delivery.

Type
Merchant of record for SaaS and digital products
First released
2021
License
Proprietary SaaS, transaction fee pricing
Maintained by
Lemon Squeezy LLC, a Stripe company
Typically used for
Indie SaaS checkout, licence keys, digital goods, affiliate programs, global tax compliance

The honest version

Lemon Squeezy pros and cons

No technology is all upside. This is where Lemon Squeezy earns its place and where it tends to cause trouble.

Where Lemon Squeezy is strong

  • Onboarding is genuinely quickA new store can be live and taking payments inside an afternoon, which is not true of every merchant of record option, and the hosted checkout removes a lot of frontend work.
  • Licence keys as a first class productSoftware activation keys, instance limits and revocation are built in rather than bolted on, which matters for self hosted tools and desktop apps.
  • Merchant of record removes tax complianceLike Paddle, Lemon Squeezy registers and remits VAT, GST and sales tax across jurisdictions, so the seller does not have to.
  • Affiliate program includedTracking, commission tiers and payouts are part of the product, which saves wiring up a separate affiliate tool for small stores.
  • Reasonable developer experienceThe REST API is predictable, the webhooks are documented, and SDKs cover the common languages. Not Stripe level polish, but comfortable.
  • Hosted checkout and overlayThe checkout works as a redirect or an overlay on your own marketing page, with enough branding control to feel owned rather than third party.

Where Lemon Squeezy bites

  • Flat rate fees add up at scaleThe included tax and chargeback handling is not free, and once a store reaches meaningful revenue the per transaction fee is more than a self served tax tool would cost.
  • Refund windows are strictRefunds after 60 days through the API return an error, and manual refunds through the dashboard require support involvement, which slows customer service responses.
  • Licence key edge casesActivation limits, machine identifier handling and revocation flows have quiet corners, and most teams discover them the week a customer legitimately swaps laptops.
  • Webhook retries are coarseA failed webhook retries a fixed number of times and then gives up, which means a deploy that briefly broke the handler can lose events if replay from the dashboard is forgotten.
  • Smaller ecosystem than Paddle or StripeFewer third party integrations, less tooling around reporting, and a smaller pool of accountants who have seen the invoices, which can matter during audit.
  • Tax exemption handling is fiddlyCollecting and validating VAT numbers for exempt customers works, but the flow has to be triggered correctly in checkout or the exemption does not apply on the first invoice.

Sound familiar?

Common Lemon Squeezy problems we fix

The Lemon Squeezy problems that bring people to us, and what you have once each one is fixed.

license key does not exist

Licence key lookups return 404

A key was issued but never stored against a customer record, or the lookup is hitting test mode while the key is in live mode. We align the environments and rebuild the mapping where it has been lost.

Keys resolve against the right customer

already activated 3/3 instances

Customer cannot activate on a new machine

The activation limit was hit by previous installs that nobody deactivated, often because a laptop was replaced. We expose a self serve deactivation path rather than needing support involvement.

Customers can move between machines

signature verification failed

Webhook signatures not matching

The handler is verifying against a parsed body rather than the raw request bytes, or a reverse proxy stripped the signature header. We verify against the exact bytes the request arrived with.

Webhooks accepted and processed

refund failed: more than 60 days

Refund API rejects legitimate refunds

The API has a 60 day limit; beyond that, a refund has to go through Lemon Squeezy support. A customer service process that assumed self serve refunds works forever will stall.

Refund flow matches the real policy

cannot be resumed while in cancelled

Subscription state transitions rejected

A subscription that is already cancelled cannot be resumed through the API, which trips flows that assumed a single reactivate action always works. We handle the specific states explicitly.

State transitions handled per status

test mode api key used against live endpoint

Keys crossed between environments

A deploy ran with test mode credentials against the live store, so live transactions are failing silently and test data is leaking in. We split the keys properly and rotate the shared ones.

Environments isolated and clean

affiliate commission mismatch

Affiliate payouts do not match expectations

Commission tiers, refunded orders and bundled products interact in ways that produce payouts affiliates dispute. We reconcile the ledger and tune the commission rules.

Payouts match the ledger

webhook delivery retrying: attempt 3 of 6

Flaky webhook handler drops events

A deploy, a cold start or an upstream dependency makes the handler fail intermittently, and Lemon Squeezy runs out of retries. We make the handler idempotent and fast enough to survive.

Handlers reliable across retries

What we do

Lemon Squeezy help, from launch to upkeep

Call us for one failing webhook, or let us set up the whole store properly.

Rescue
Licence keys not resolving, webhooks failing silently, or refunds hitting the wrong edge case. We stabilise the store and then explain what caused it.
Licence key design
Activation limits, machine identifiers, revocation flows and self serve deactivation set up so support tickets about swapped laptops stop arriving.
Webhook reliability
Raw body signature verification, idempotent handlers, retry safe side effects, and replay from the dashboard documented so events are not lost on bad deploys.
Affiliate program setup
Commission tiers, tracking links, refund handling in the ledger, and payouts reconciled so affiliates and finance see the same numbers.
Store migrations
Moves on or off Lemon Squeezy done without losing customers: Gumroad to Lemon Squeezy, Lemon Squeezy to Stripe, or splitting products across platforms.
Managed Tech
Monthly reviews of webhook delivery, refund rate, licence lifecycle and tax exemption handling, plus a team to call when a launch drives a surprise support spike.

How it works

From first message to fixed

  1. Look Free estimate

    Tell us what's going wrong. We look at it, then tell you plainly what's wrong and what it will cost.

  2. Fix

    We fix the cause, not the symptom. If something is down, getting it back up comes first.

  3. Harden

    Backups, monitoring, updates and access, so the same problem can't quietly come back.

  4. Hand back or stay on

    You get a plain-language write-up. Or we stay on for hosting, upkeep and new work.

Often found together

Running Lemon Squeezy alongside something else?

We work on the whole stack, so the problem can be wherever it actually is.

Questions

Lemon Squeezy questions

Something else? Call+1 737 727 7327

Should we pick Lemon Squeezy or Paddle for our SaaS?

Lemon Squeezy fits earlier stage products, indie SaaS and digital creators who want to be live quickly and benefit from the built in licence key and affiliate features. Paddle fits better once revenue and compliance needs scale up, since its product and subscription primitives are more mature. We compare both against your actual store size and roadmap before suggesting one.

Why do some of our licence keys return 404?

The common causes are a key issued in test mode being looked up in live mode, a key that was revoked but is still referenced by the client, or a customer migration that lost the mapping between order and key. We align the environments, validate the full issue-to-lookup chain against a known good order, and rebuild any missing mappings from the webhook history.

How do we handle refunds outside the 60 day API window?

Those refunds have to go through Lemon Squeezy support rather than the public API. The right fix is a customer service runbook that identifies when to use each path, plus a check in the app that surfaces an older order with the appropriate message rather than attempting an API refund that will fail.

Can you help us move from Gumroad or another platform?

Yes. We export the customer and subscription data, map products and prices into Lemon Squeezy, run the two platforms in parallel for a billing cycle, and move active subscriptions to the new platform in a controlled way rather than a big bang.

Why are our affiliates disputing payouts?

Usually refunded orders, bundled products, or tier thresholds that were not what the affiliate expected. We pull the full ledger, reconcile it against the commission rules, and either correct the payout or tighten the rules so the next cycle is unambiguous.

How much does Lemon Squeezy help cost?

Estimates are at no charge. Describe the store, the specific symptom and where it is blocking you, and we send a price and a plan before anything is changed.

Free estimate

Lemon Squeezy setup not holding up?

Tell us what you're running and what's going wrong. A person reads it and comes back with an estimate.

  • No charge to find out what it will take
  • If it's urgent, say so

Replies come from a person. By sending, you authorize us to email you back. No marketing.