· AvaGuru Engineering Team · migration guides · Updated · 13 min read

How to Migrate from Lemon Squeezy to Telegram Without Losing Buyers

Move one-time products and license keys from Lemon Squeezy to a Telegram store. Exact export steps, a key export script, and what changes for fees and tax.

To move a Lemon Squeezy store to Telegram without losing past buyers, recreate your products in the new store, export the Orders CSV from Lemon Squeezy, pull your license keys through the Lemon Squeezy API (they are not in the CSV), import both files into AvaGuru’s Restore Buyers page, and send past buyers one link. Each buyer opens it in Telegram, confirms their purchase email with a 6-digit code or pastes their license key, and gets the same files and the same key back at no cost. Existing recurring billing agreements cannot transfer into Stars, and AvaGuru does not take over the sales tax handling that Lemon Squeezy provided as Merchant of Record. AvaGuru supports new Telegram Stars subscriptions for renewing software licenses or channel/group access on paid plans with the feature enabled, but buyers must opt in themselves. Importing a license does not start those renewals.

The rest of this guide covers each step with the exact export columns, a script for the license keys, and the parts most migration guides leave out.

Why are sellers moving off Lemon Squeezy in 2026?

Stripe acquired Lemon Squeezy in July 2024 and promised at the time to “continue delivering the same fantastic product”. On January 28, 2026, Lemon Squeezy published a 2026 update that acknowledged “slower support responses and less frequent product updates” and said: “Our goal is to provide Lemon Squeezy users an easy way to migrate to Stripe Managed Payments.”

Lemon Squeezy’s newer official migration page gives December 2, 2026 for migration tools and March 31, 2027 for stopping transactions. It describes a Stripe migration path for eligible card subscriptions. Check its current dates and eligibility before planning; moving card billing, license validation and product delivery are separate tasks.

Most migration guides you will find are written by other payment platforms and assume you sell SaaS subscriptions. This one is for sellers of one-time digital products: ebooks, templates, courses, plugins and desktop software with license keys, who want to sell inside Telegram.

What can you move from Lemon Squeezy to a Telegram store?

What you have on Lemon Squeezy Can it move to AvaGuru? How
Products, files and prices Yes, by hand Create each product in AvaGuru and upload the files. There is no bulk product import yet.
Past one-time purchases Yes Orders CSV, imported on the Restore Buyers page
License keys already issued Yes Exported through the API, imported with the orders
Buyer email list for announcements Stays with you AvaGuru does not email your customers. You announce the move from your own tools.
Existing recurring billing agreements Cannot transfer into Stars They cannot transfer into Stars. Assess Lemon Squeezy’s eligible card-subscription migration separately, or ask buyers to authorize a new 30-day Stars subscription for a supported AvaGuru product.
Discount codes, affiliates No Recreate the codes you still need
Sales tax handling No You become responsible. See the tax section below.

The import steps below cover purchase recovery. Software sellers should also read recurring software licenses on Telegram: AvaGuru can import existing keys with their supplied expiry and supported device records, while a new Stars subscription issues a new key. Future renewals extend that new subscription key, not the imported one. General SaaS billing is a separate evaluation.

Can you start new subscriptions for Telegram channel or group access?

Yes. On a paid AvaGuru plan, you can sell access to a private Telegram channel or group with a recurring Telegram Stars subscription. Telegram renews it every 30 days.

Add your store bot to the chat as an administrator with Invite users and Restrict members permissions, connect it under Paid channels in the Admin Portal, then create a digital product with Channel / group access delivery and a recurring price. Buyers open the product in your store’s Telegram Mini App and approve a new recurring Stars payment.

Existing Lemon Squeezy recurring billing agreements cannot transfer through Restore Buyers, and there is no InviteMember subscription import. Explain the new price and 30-day billing period to existing subscribers, ask them to opt in, and coordinate the end of their old billing so they do not pay twice for the same period. Keep existing paid access available while you arrange the transition.

How do you export orders and license keys from Lemon Squeezy?

You need two files: the orders file, which says who bought what, and a license key file, which says which key belongs to which order.

Export the Orders CSV

  1. In the Lemon Squeezy dashboard, open Orders.
  2. Click Export.
  3. Lemon Squeezy emails the CSV to the store owner’s address. It does not download in the browser.

According to the Lemon Squeezy export documentation, the file has these columns:

identifier, order_number, product_name, variant_name, user_name, user_email, city, country, postal_code, card_brand, card_last_four, currency, currency_rate, subtotal, discount_total, tax, total, tax_name, tax_rate, tax_number, date_utc

Two gaps matter for a migration. There is no license key column, and there is no refund status column, so refunded orders look the same as paid ones.

AvaGuru’s Lemon Squeezy preset reads user_email, product_name, identifier and date_utc and ignores the rest. You do not need to edit the file, and card and address columns are never stored.

Pull your license keys with the Lemon Squeezy API

Lemon Squeezy lists license keys through GET /v1/license-keys. Each key belongs to an order_id, which is the order’s numeric API ID, not the identifier in the CSV. The script below joins the two and writes a licenses.csv that the Restore Buyers page understands. It also skips keys you disabled and keys on orders that are not in paid status, and prints those orders so you can remove them from the orders CSV too.

Create an API key under Settings → API in Lemon Squeezy, look up your store ID under Settings → Stores, and run this with Node.js 18 or later:

// export-ls-keys.mjs
// LS_API_KEY=... LS_STORE_ID=... node export-ls-keys.mjs > licenses.csv
const API = 'https://api.lemonsqueezy.com/v1';
const headers = { Accept: 'application/vnd.api+json', Authorization: `Bearer ${process.env.LS_API_KEY}` };

async function all(path) {
  const rows = [];
  for (let page = 1, last = 1; page <= last; page++) {
    const res = await fetch(`${API}${path}?filter[store_id]=${process.env.LS_STORE_ID}&page[size]=100&page[number]=${page}`, { headers });
    if (res.status === 429) { await new Promise((done) => setTimeout(done, 60_000)); page--; continue; }
    if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
    const body = await res.json();
    rows.push(...body.data);
    last = body.meta.page.lastPage;
  }
  return rows;
}

const orders = new Map((await all('/orders')).map((order) => [String(order.id), order.attributes]));
const quote = (value) => `"${String(value ?? '').replace(/"/g, '""')}"`;
const lines = ['order_identifier,license_key'];
for (const { attributes: key } of await all('/license-keys')) {
  const order = orders.get(String(key.order_id));
  if (!order || key.status === 'disabled') continue;
  if (order.status !== 'paid') { console.error(`Remove ${order.identifier} from the orders CSV: ${order.status}`); continue; }
  lines.push([order.identifier, key.key].map(quote).join(','));
}
process.stdout.write(lines.join('\n') + '\n');

This basic script exports key strings only. For software licensing, also export each key’s expiry, status and activation limit, plus an optional device file; otherwise the import cannot preserve information you did not supply. See the software-license migration plan before using this export for subscription-backed software. The API returns at most 100 records per page and allows 300 calls per minute. Runtime depends on response times and rate limiting. Delete the API key when you are done.

Remove refunded orders before you upload

The orders CSV cannot tell AvaGuru which orders were refunded. Delete the rows the script printed (refunded, partially refunded or fraudulent orders) before you upload. Otherwise a buyer who got their money back could restore the product for free.

How do past buyers restore their purchases in Telegram?

What the merchant does

  1. Create each product in AvaGuru, upload the files and set stock. Digital products start at stock 0, which blocks orders until you change it.
  2. Open Restore Buyers in the AvaGuru Admin Portal, choose Lemon Squeezy, and upload the orders CSV and licenses.csv.
  3. Check the preview. Nothing is saved yet. It shows the number of rows and buyers, the rows it skipped and why, and how many keys already exist in your store.
  4. Match each Lemon Squeezy product to an AvaGuru product. Products you leave unmatched are skipped. For a license-key product whose old keys you could not export, choose whether to issue a new key from your key pool when the buyer restores, or deliver files only.
  5. Enter a short reason for the audit log and import.
  6. Copy the announcement text the page prepares. It contains your store name and the restore link, https://t.me/<your_bot>?start=claim. Send it from Lemon Squeezy’s email tools or your newsletter.

Imports accept up to 5 MB and 5,000 rows per file. Split bigger lists into several imports; importing the same file twice does not create duplicates.

What the buyer does

The buyer opens the link and taps Start. The store bot replies with a button that opens the Restore purchases page. Buyers can also send /claim to the bot. They choose one of two proofs:

  • License key. They paste their key. Owning the key proves the purchase, so that one purchase is restored immediately.
  • Email. They type the email they used on Lemon Squeezy, receive a 6-digit code from no-reply@myavaguru.com, and enter it. Every purchase under that email is restored at once.

A key restores only its own purchase. Other purchases under the same email still need the email code, so a leaked key cannot expose someone’s whole order history.

What a restored purchase looks like

Each restored purchase becomes a normal completed order with a price of 0. The buyer sees it in their order list with Download and Show key buttons, and the bot sends one message listing everything that was restored. If a file has a download time limit, the limit starts when the buyer restores, not when they bought it on Lemon Squeezy.

Restored orders are kept out of your numbers. They do not count toward your plan’s monthly order limit, do not show as revenue, cannot be refunded (there was no payment), and do not trigger post-purchase marketing messages.

Will existing license keys keep working after you leave Lemon Squeezy?

The key string survives the move: the buyer gets back exactly the key they had. Whether your software keeps accepting it depends on how the software checks keys.

How your software checks keys After the move
Offline, against a format or signature you control Keeps working. Nothing changes.
Online, against Lemon Squeezy’s License API (/v1/licenses/validate) Still calls Lemon Squeezy. Lemon Squeezy has not documented what happens to validation for a store that stops selling or closes.
Online, against your own server Keeps working if your server still knows the keys

If your app calls the Lemon Squeezy License API, do not close the Lemon Squeezy store when you move. Unpublish the products so nobody can buy there, keep the account open, and ship an update that checks keys another way before you shut it down. AvaGuru offers a public activation, validation and deactivation API for your own integrated software. Importing keys does not redirect installed applications: test and release the necessary client or endpoint update, including metadata and device-ID assumptions. See the recurring software license guide for the staged transition.

What changes for fees, payouts and tax?

Lemon Squeezy AvaGuru store in Telegram
Platform cost 5% + $0.50 per order, +1.5% outside the US, +1.5% for PayPal Monthly subscription from $19, no share of each sale (pricing)
How buyers pay for digital products Card, PayPal Telegram Stars, which Telegram requires for digital goods in bots
What you receive Payout in your currency Stars, worth about $0.013 each when withdrawn through Fragment to a TON wallet
When you can withdraw Lemon Squeezy payout schedule Up to 21 days after each sale
Sales tax and VAT Lemon Squeezy collects and remits as Merchant of Record You are responsible

Use the Telegram Stars calculator to set Star prices that give you the payout you had on Lemon Squeezy.

The tax row is the one most guides skip. Telegram’s terms for bot developers say: “You are solely responsible for all taxes and fees associated with any income you receive”, and “Telegram will not inform you of, nor calculate or pay out any taxes and fees on your behalf.” Buyers in some regions pay local tax when they buy Stars from Apple, Google or Telegram, but Telegram’s terms do not say that this covers the tax you owe on your own sales. Talk to an accountant before you move if you sell to buyers in the EU, UK or other places that tax digital products.

What is the order of steps for a Lemon Squeezy migration?

  1. Decide how existing billing and license validation will transition. If you offer new Stars subscriptions, plan buyer opt-in, the new key for software subscribers, and the end of old billing separately.
  2. Create your products in AvaGuru and test one purchase yourself.
  3. Export the Orders CSV and run the key script.
  4. Delete refunded and fraudulent orders from the CSV.
  5. Import both files on the Restore Buyers page and match the products.
  6. Restore one of your own test purchases by email and by key to check the flow.
  7. Send the announcement to your buyers.
  8. Unpublish the one-time products you have moved, but keep the Lemon Squeezy account open while existing subscriptions or license checks depend on it and until the refund and chargeback windows on your last orders have closed.
  9. Check the Restore Buyers page after two weeks. The export button there downloads every imported purchase with its restore status, so you can send a reminder to buyers who have not restored yet.

Frequently asked questions

Can I move Lemon Squeezy subscriptions to Telegram?

Existing Lemon Squeezy billing agreements cannot transfer into AvaGuru’s Stars subscriptions. Buyers can approve a new 30-day Stars subscription for renewing software licenses or channel/group access on a paid plan with the feature enabled. For software, the imported key keeps its supplied expiry; the new subscription issues a new key. Read recurring software licenses on Telegram before planning billing dates. Lemon Squeezy’s eligible card migration through Stripe is a separate route; this flow does not import InviteMember subscriptions.

Do past buyers need a Telegram account?

Yes. Restoring happens inside your store’s Telegram bot, so buyers need Telegram on their phone or desktop. Buyers who do not use Telegram keep whatever access they still have on Lemon Squeezy.

What if a buyer no longer has access to their purchase email?

They can restore by pasting their license key. If the product had no key, ask the buyer for their order number, find the order in your own Lemon Squeezy export, and import that purchase again with an email the buyer can access.

Does AvaGuru see or keep my customers’ email addresses?

The uploaded CSV is held for at most 30 minutes while you review the preview, then deleted. AvaGuru stores only a keyed hash of each email, which is enough to check a buyer’s code but cannot be turned back into the address. That is also why the export from the Restore Buyers page has no email column. License keys are stored encrypted.

Is the Restore Buyers feature included in every plan?

Yes, on every plan, and restored purchases do not count toward the monthly order limit, so even a large back catalog fits on a small plan.

Can I import from Gumroad or Payhip as well?

Yes. The Restore Buyers page has presets for Gumroad and Payhip exports and a generic format for any other platform. See how to move from Gumroad to Telegram.

Sources

This guide was written by the AvaGuru Engineering Team, who built the Restore Buyers import. The original export walkthrough was checked against official documentation on November 16, 2026. On November 17, we updated the migration timeline and licensing boundaries and linked the software subscription workflow. Automated implementation checks do not establish a completed customer migration or live Stars renewal. We have not yet published restore rates from real migrations; we will add them here once the first stores have moved. If you are planning a move and want help with the files, contact us.

Back to Blog

Related Posts

View All Posts »