Migrate from Lemon Squeezy before 31 March 2027

Lemon Squeezy stops processing payments on 31 March 2027. One command copies your products, plans, trials and discount codes to AgentaOS. Your Lemon Squeezy account is only read, never changed.

# 1. Dry run: reads your Lemon Squeezy store, creates nothing
export LEMONSQUEEZY_API_KEY=...
npx @agentaos/migrate --from lemonsqueezy

# 2. Create it in AgentaOS (start with a test key)
export AGENTAOS_API_KEY=sk_test_...
npx @agentaos/migrate --from lemonsqueezy --apply --switch-code

Lemon Squeezy announced the wind-down on 16 November 2026 and closed new store sign-ups the same day: its announcement (checked 16 November 2026).

Prefer that we do it with you? Email [email protected] with your store link and we move your products together, free. More: what the shutdown means · Lemon Squeezy vs Stripe Managed Payments · 6 alternatives.

What moves

Everything that can move as-is moves. Everything else is listed with the reason, so nothing disappears quietly.

From Lemon SqueezyOn AgentaOSNotes
One-time productsMovedName, description, price, image
Subscription plansMovedMonthly and yearly, with trials
Discount codesMovedOn AgentaOS a code takes money off the first invoice
Active subscribersListedEach with plan, renewal date and new link
Saved cardsNot movedLemon Squeezy keeps them; see below
License keysNot movedAgentaOS does not issue license keys; issue them from your app on the sale webhook

Left behind with the reason, in skipped.csv: quarterly or weekly billing, prices in currencies other than EUR or USD, free or pay-what-you-want products.

The move, step by step

  1. Dry run. Set LEMONSQUEEZY_API_KEY and run the command. It writes summary.md and skipped.csv and creates nothing.
  2. Try it in test mode. Add --apply with an sk_test_ key, open a new link and pay with a test card.
  3. Go live. Verify your business on AgentaOS, then run --apply again with an sk_live_ key.
  4. Swap your links. redirects.csv pairs each Lemon Squeezy buy link with its new link. New buyers pay on AgentaOS from that moment.
  5. Move your subscribers before their next renewal, and before 31 March 2027.

Your subscribers, without paying twice

Saved cards stay with Lemon Squeezy. So each subscriber subscribes once on the new link, before their renewal date.

  1. subscribers.csv lists every active subscriber with their plan, renewal date and new link.
  2. email-to-subscribers.md is a short email to send a week or two before each renewal.
  3. --switch-code makes one random code that makes their first AgentaOS invoice free, because they already paid for the current period. Capped at your number of subscribers, valid 60 days.
  4. When someone subscribes on AgentaOS, cancel their Lemon Squeezy subscription at the end of the period they paid for.

Know before you move

What you can sell

AgentaOS is a merchant of record for software and digital products. Physical goods are not supported. Product guidelines.

How buyers pay

Card, Apple Pay and Google Pay, and bank transfer on EUR sales. PayPal is not available, so a subscriber who paid with PayPal subscribes again with a card.

Where you get paid

Check your country and its payout route before you start. Find your country. Fees are on Pricing.

Or ask your AI agent

With the AgentaOS plugin in Claude Code, say “move me off Lemon Squeezy”. It runs the dry run, shows you what moves and what stays, creates it only after you say yes, then swaps the old buy links in your code.

Common questions

When does Lemon Squeezy stop processing payments?

On 31 March 2027. Lemon Squeezy announced the wind-down on 16 November 2026 and closed new store sign-ups the same day.

Can I move my subscribers' saved cards?

No. Lemon Squeezy holds the cards and they are not handed to another seller. Each subscriber subscribes once on the new link, timed to their renewal date.

Will my subscribers pay twice?

No, if you time it right. They keep the period they already paid for, subscribe on AgentaOS before it ends, and you cancel the old subscription at the end of that period. The optional switch code makes their first AgentaOS invoice free.

Does the tool change my Lemon Squeezy account?

No. It only sends read requests with your own API key. It never edits, pauses or cancels anything there.

What about license keys?

AgentaOS does not issue license keys. Keep the keys your customers have, and issue new ones from your own app when the sale webhook arrives.

What does it cost?

The tool is free and open source (Apache-2.0). Selling on AgentaOS is 4.5% + €0.50 per sale with no monthly fee, plus 1.5% on cards from outside the EEA. Pricing.

Try it on a test account first

The dry run creates nothing. Run it, read summary.md, and decide.

Get an AgentaOS key →

Compare first: Lemon Squeezy alternatives · Merchant of Record fees, side by side · Moving from another provider