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

How to Move from Gumroad to Telegram Without Losing Past Buyers

Move a Gumroad store to Telegram and let past buyers restore their files and license keys. Export steps, the columns that matter, fees and tax compared.

To move a Gumroad store to Telegram without losing past buyers, export your sales from Gumroad’s Sales tab before you delete anything, recreate your products in an AvaGuru store, import the sales file on the Restore Buyers page, and send 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 their files and the same key again at no cost. The Gumroad CSV already includes license keys, so unlike most platforms you need no API script. Existing Gumroad membership billing agreements cannot transfer into Stars. You can offer new Telegram Stars subscriptions for channel or group access on a paid AvaGuru plan, but buyers must opt in themselves. Once you sell outside Gumroad you take over the sales tax that Gumroad handles as Merchant of Record.

The sections below go through each step, the export columns that decide what gets restored, and the two mistakes that can lose buyers for good.

Why move a Gumroad store to Telegram?

The usual reason is cost. Gumroad’s fee page says: “For sales made on Gumroad’s website, we charge a 10% + $0.50 fee + sales tax per transaction. This does not include: Credit card processing (2.9% + $0.30)”. Sales that come through Gumroad’s Discover marketplace pay “a flat 30% fee”. Once a seller’s paid sales pass $20,000 in a calendar month, direct sales that month drop to 5% + $0.50.

For a $20 template sold through your own link, that is $2.50 to Gumroad plus about $0.88 in card processing, or roughly 17% of the price. Through Discover it is $6.

The second reason is audience. If your buyers already follow you on a Telegram channel or group, a store inside Telegram removes the step where they leave the app to pay.

Most “migrate from Gumroad” guides come from other checkout platforms, and they stop at “export your customers and import them”. They do not explain how a buyer proves a past purchase on the new store, what happens to license keys, or which Gumroad actions remove buyers from your export. This guide covers those parts.

What can you move from Gumroad to a Telegram store?

What you have on Gumroad 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 Sales CSV, imported on the Restore Buyers page
License keys Yes They are in the same sales CSV
Followers and customer emails for announcements Stays with you AvaGuru does not email your customers. You announce the move from Gumroad or your newsletter.
Existing memberships and subscription billing agreements Cannot transfer into Stars Keep existing memberships on Gumroad, or invite buyers to opt in to a new 30-day Telegram Stars subscription for channel or group access on a paid AvaGuru plan.
Discount codes, affiliates, upsells No Recreate what you still need
Sales tax handling No You become responsible. See the tax section below.

Can you sell new memberships in Telegram?

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. This is channel or group access, not a replacement for every kind of Gumroad membership or recurring digital product.

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.

Restore Buyers does not transfer recurring billing agreements or start a subscription. There is no InviteMember subscription import either. If you want existing Gumroad members to join, explain the new price and 30-day billing period, ask them to subscribe themselves, and coordinate the end of their old membership so they do not pay twice for the same period. Keep their existing paid access available while you arrange the transition.

What should you do on Gumroad before you leave?

Two Gumroad behaviours make the order of steps matter.

Export before you delete any product

Gumroad’s help page on deleting a product says deleted products’ sales “will also not show up in the exportable CSV of your sales”. If you delete a product first and export afterwards, its buyers are missing from the file and cannot restore anything in Telegram. Export first, keep the file, and only then tidy up Gumroad.

Unpublish products instead of deleting them

When you unpublish a product, Gumroad says “Customers who have bought the product will still be able to access their files.” That gives buyers time to move at their own pace, and they lose nothing if they never open your Telegram store.

Deleting a membership product “cancels everyone’s subscription”, so leave memberships alone until you have decided what happens to them.

Do not close the account while your software checks keys there

If your app verifies keys with Gumroad’s POST /v2/licenses/verify, it keeps calling Gumroad after the move. Gumroad does not document what that endpoint returns after a product is deleted or an account is closed. Keep the account open with products unpublished until you ship an app update that checks keys another way. AvaGuru can preserve the key string and provides a public licensing API for your own integrated software. It does not automatically replace Gumroad’s verification endpoint in installed clients. Test the application update and imported entitlements before switching services. For new software subscriptions, see recurring software licenses on Telegram; buyers approve Stars billing and receive a new subscription key.

How do you export your sales from Gumroad?

  1. Open the Sales tab in the Gumroad dashboard.
  2. Click the Export icon.
  3. Choose a date range that starts before your first sale, and click Download. Large exports are emailed to you instead.

The export uses UTC dates, and Gumroad’s analytics help page suggests adding “a one-day buffer” to each end of the range. To export one product only, click the Filter icon first and pick it.

Which Gumroad CSV columns matter for the import?

The export has many columns. AvaGuru’s Gumroad preset reads these and ignores the rest:

Gumroad column What AvaGuru does with it
Purchase Email The email a buyer confirms to restore the purchase. It is stored only as a keyed hash.
Item Name Matched to an AvaGuru product during the import
Purchase ID Prevents duplicates if you import the same file twice
Purchase Date Shown to the buyer on the restored order
License Key Given back to the buyer on restore, unchanged
Refunded?, Disputed?, Access Revoked? A row with any of these set is skipped

Gumroad has no separate chargeback column: a chargeback sets Disputed?. Skipping all three columns means a buyer who got their money back, or whose access you revoked, cannot restore the product for free.

You do not need to edit the file. Card and address columns are never read.

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 Gumroad and upload the sales CSV.
  3. Check the preview. Nothing is saved yet. It shows the number of rows and buyers, every skipped row with its line number and reason, and how many keys already exist in your store.
  4. Match each Gumroad product name to an AvaGuru product. Unmatched products are skipped. For a license-key product with no key in the file, 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 to your customers from Gumroad’s email updates or your own newsletter.

Each file can hold up to 5 MB and 5,000 rows. Split bigger exports by date range and import them one by one.

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 then choose one of two proofs:

  • License key. They paste their key, and that one purchase is restored immediately.
  • Email. They type the email they used on Gumroad, 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 key shared online cannot unlock someone’s whole purchase history.

What a restored purchase looks like

Each restored purchase becomes a completed order with a price of 0. The buyer gets Download and Show key buttons on the order, and the bot sends one message listing what was restored. Download time limits start from the restore, not from the original Gumroad purchase.

Restored orders do not count toward your plan’s monthly order limit, do not show as revenue, cannot be refunded, and do not trigger post-purchase marketing messages.

How do Gumroad and Telegram compare on fees, payouts and tax?

Gumroad AvaGuru store in Telegram
Platform cost 10% + $0.50 per direct sale, plus 2.9% + $0.30 card processing; 30% on Discover 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
Payout $100 minimum; sales held at least 7 days on weekly, monthly and quarterly schedules Stars worth about $0.013 each, withdrawn through Fragment to a TON wallet up to 21 days after each sale
Sales tax and VAT Gumroad collects and remits as Merchant of Record since January 1, 2025 You are responsible

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

The tax row deserves the most attention. Gumroad’s pricing page says that since January 1, 2025, “Gumroad handles ALL your tax obligations”. Telegram does the opposite. Its 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, but Telegram’s terms do not say that covers the tax you owe on your own sales. Check with an accountant before you move if many of your buyers are in the EU, the UK or other places that tax digital products.

What is the order of steps for a Gumroad migration?

  1. Decide what stays on Gumroad: existing memberships and the license check if your app uses Gumroad’s verify endpoint. If you offer new Telegram channel or group subscriptions, plan buyer opt-in and the end of old billing separately.
  2. Export the full sales CSV and keep a copy.
  3. Create your products in AvaGuru and test one purchase yourself.
  4. Import the CSV on the Restore Buyers page and match the products.
  5. Restore one of your own Gumroad purchases by email and by key to check the flow.
  6. Send the announcement to your customers.
  7. Unpublish your Gumroad products. Do not delete them, and do not close the account while memberships or license checks still depend on it.
  8. After two weeks, export the restore status from the Restore Buyers page and send a reminder to buyers who have not restored yet.

Frequently asked questions

Will my Gumroad buyers lose access when I leave?

Not if you unpublish instead of deleting. Gumroad keeps their files available in their library. Restoring in Telegram is an extra copy, not a replacement they are forced into.

Can I move Gumroad memberships to Telegram?

You cannot import or transfer existing Gumroad membership billing agreements. AvaGuru supports new Telegram Stars subscriptions for paid channel or group access, renewing every 30 days, on paid AvaGuru plans. Each buyer must approve a new subscription; restoring a past purchase does not enroll them. Keep memberships on Gumroad until you have arranged any transition with those buyers.

Do I need the Gumroad API to export license keys?

No. The sales CSV has a License Key column, so one file covers both purchases and keys.

What if a buyer used a different email on Gumroad?

They can paste their license key instead. For products without keys, ask the buyer for their Gumroad receipt, find the purchase in your export, and import that row again with an email the buyer can access.

Does AvaGuru keep my customers’ email addresses?

No. The uploaded file is held for at most 30 minutes while you review the preview, then deleted. AvaGuru stores a keyed hash of each email, which can confirm a buyer’s code but cannot be turned back into the address. License keys are stored encrypted.

Is the Restore Buyers feature on every plan?

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

Can I also import from Lemon Squeezy or Payhip?

Yes. See how to migrate from Lemon Squeezy to Telegram. Payhip has its own preset on the Restore Buyers page.

Sources

This guide was written by the AvaGuru Engineering Team, who built the Restore Buyers import. We checked each Gumroad statement against Gumroad’s help center and its open-source code on November 16, 2026. While writing it, we found that our import checked only the Refunded? column, so disputed rows would have been restorable, and fixed the import to check all three columns before publishing. We have not yet published restore rates from real migrations; we will add them once the first stores have moved. If you want help with your export, contact us.

Back to Blog

Related Posts

View All Posts »