How to move Gumroad license keys and software buyers to Whop
Quick answer
License keys can't be transferred. Whop issues its own key with each membership through its Software app, and its docs describe no way to bring your own. So you switch over instead: add a Whop check on your server, ship an app update that accepts either key, give past buyers a free Whop claim link that comes with a Whop key, and keep Gumroad's check running until a date you announce.
Let your AI agent do the busywork
Paste the prompt into any AI agent and it moves your Gumroad business to Whop, with you approving each step.
On this page
- Why keys can't be transferred
- How the two checks compare
- Step 1: Export who owns which key
- Step 2: Create the product on Whop and add the Software app
- Step 3: Add a Whop key check on your server
- Step 4: Ship an app update that accepts either key
- Step 5: Give past buyers their Whop key
- Step 6: Retire the Gumroad check on an announced date
- What doesn't move
- Troubleshooting
- Your software, live on Whop
- FAQ
- Sources
We built MoveToWhop, the free tool this guide uses, and we may earn a referral commission from Whop if you create a Whop through our links. It costs you nothing.
If you sell software, plugins or scripts on Gumroad, your app probably checks each buyer's Gumroad license key. Those keys can't come with you, so the move is a switchover: both kinds of key work for a while, every past buyer gets a Whop key, and then the Gumroad check goes. This guide covers the software side. The full Gumroad to Whop plan covers products, members and fees.
Why keys can't be transferred
Gumroad generates its own keys; its help center says you either use those or manage keys outside Gumroad. On Whop, the key comes from the membership: Whop's docs say each purchase of a product that includes the Software app comes with a unique key, and the API only returns a key when the product has that app. And Whop's API can't create memberships directly. Its docs say checkout does that.
So nobody, including MoveToWhop, can carry a key string from Gumroad to Whop. What you can do is give every past buyer a free way through Whop checkout, which creates their membership and their new key.
How the two checks compare
From Gumroad's license key help article and Whop's SaaS docs, checked October 14, 2026.
| Gumroad | Whop | |
|---|---|---|
| Where keys come from | The License key block on the product's content page | The Software app on the product |
| The check | POST https://api.gumroad.com/v2/licenses/verify with your product ID and the key | memberships.retrieve with the key in place of a membership ID |
| Secret needed | None: product ID and key | Your Whop API key, which can read and change every membership |
| Where it can run | Gumroad says the API accepts calls from the browser | Your own server only, never in the app you ship |
| Limiting use | A uses count that goes up on each verify unless you send increment_uses_count=false | One machine per key: you store a hardware ID in the membership's metadata |
| After a cancellation | The key stays enabled; subscription_cancelled_at fills in when the membership ends | The membership's status changes; Whop's example accepts active, trialing and completed |
| Unknown key | A 404 response | A 404 error |
| Resetting | Reset the uses count on the Sales page | Buyers reset from their orders, or your server clears the metadata |
The middle rows are the real work. If your app calls Gumroad straight from the user's machine today, the Whop check needs a small server endpoint that holds your Whop API key.
The free tool's Gumroad route with test data, from Sync to Move to Whop. Under 20 seconds, no sound.
Step 1: Export who owns which key
Download your sales CSV from Sales, then Export, with the date range set back to your first sale. Our Gumroad export guide covers the details. Three columns are your key record:
- License Key: the key each buyer got
- License Key Activation Count: how many times it was verified
- License Key Enabled?: 1 if it still works
Keep this file. After the cutoff, it's how you answer "I bought this in 2024, what's my key?"
Step 2: Create the product on Whop and add the Software app
Open the free Gumroad to Whop tool, pick Gumroad and press Log in with Gumroad. It reads your products, prices and buyers through Gumroad's API. Move to Whop creates the products and plans, a hidden free claim plan for one-time buyers, and hidden trial-aligned plans for subscribers. It doesn't create license keys.
Then open the product on Whop and install the Software app. Add your software's name and download link. Whop's docs say buyers then see their key and the download in their orders.
Step 3: Add a Whop key check on your server
Whop's SaaS docs lay out the check. In short, your server:
- Creates an account API key under Developer, then API keys in your Whop dashboard, and keeps it on the server.
- Looks up the key the app sends with
memberships.retrieve, passing the key in place of a membership ID. An unknown key returns a 404. - Accepts the key only if the membership's status is active, trialing or completed. Add past_due if you let buyers keep access while Whop retries a failed renewal.
- Binds the key to one machine: if the membership's metadata has no hardware ID, it saves the one the app sent; if it has one, the two must match.
Buyers can reset their key from their Whop orders. Your server can reset it too by clearing the membership's metadata.
Step 4: Ship an app update that accepts either key
Change your app to send whatever key the user enters to your server, and have the server:
- Try Whop first.
- If Whop answers 404, call Gumroad's verify endpoint with your product ID and the key. Send
increment_uses_count=falseon repeat checks, so the uses count doesn't climb with every launch. - Treat a Gumroad key as valid while its purchase isn't refunded or disputed and, for subscriptions, while
subscription_cancelled_at,subscription_ended_atandsubscription_failed_atare empty.
Ship this update before you send any claim links, so a buyer who switches to a Whop key isn't locked out by an older version.
Step 5: Give past buyers their Whop key
Send each past buyer their claim link from the Done screen's member list, with a short note: claim free access on Whop, find your new key in your Whop orders, enter it in the app. MoveToWhop doesn't send email for you, and our announcement templates have wording.
- One-time buyers claim a hidden free plan on the product. Each claim creates a Whop membership with its own key.
- Subscribers claim a hidden plan at their current price, with a free trial that ends on their next Gumroad renewal. Our guide to moving Gumroad members without double billing covers cancelling them on Gumroad without breaking their key.
Claim one link yourself with a second email address first, and check that a key appears in your orders and that your updated app accepts it.
Step 6: Retire the Gumroad check on an announced date
Pick a cutoff a few months out, tell buyers in your first email, and remind them twice. On the date, ship the update that removes the Gumroad fallback.
Until then, keep Gumroad running. Unpublish the product to stop new Gumroad sales; that keeps your buyers' purchases and data in place. Don't delete the product or the account while your app still checks Gumroad keys. A deleted product's sales also drop out of your sales export, which is your record of who owned which key.
What doesn't move
- Key strings. Every buyer gets a new Whop key.
- Activation counts and seats. Whop's docs describe one machine per key, with no uses count or seat count.
- Gumroad's license lookup page. Buyers find Whop keys in their Whop orders instead.
- Your verify code. The Whop check is a new server endpoint, not a URL swap.
Troubleshooting
| Problem | Likely cause | Fix |
|---|---|---|
| A claimed buyer has no key in their Whop orders | The product doesn't include the Software app | Add the Software app to the product |
| Your server gets a 404 for a key the buyer just claimed | The key is from Gumroad, or was mistyped | Fall back to Gumroad's verify, and check the key in their Whop orders |
| A buyer's key says it's bound to another machine | The hardware ID in metadata is from their old computer | Have them reset it from their Whop orders, or clear the metadata |
| Gumroad uses counts keep climbing | Each launch calls verify with the default settings | Send increment_uses_count=false on repeat checks |
| A subscriber's Gumroad key stopped working after you cancelled them | Your app locks keys once subscription_cancelled_at is set | Make sure they claimed their Whop key before their Gumroad period ended |
Your software, live on Whop
Once your app accepts Whop keys and past buyers have claimed theirs, new sales run through Whop checkout and Whop issues every key. Weighing the move first? Compare Whop and Gumroad, check the Gumroad fees breakdown, or see the Gumroad alternatives. Ready? Start your free Gumroad to Whop move.
Frequently asked questions
Can I import my Gumroad license keys into Whop?
No. Whop's docs describe keys that Whop issues itself, one with each purchase, when the product includes its Software app, and no way to bring your own key strings. Run both checks side by side until your buyers have Whop keys.
Do I need a server to check Whop license keys?
Yes. Gumroad's verify call only needs your product ID and the key, so many apps call it directly. Whop's check uses your Whop API key, which can read and change every membership in your business, so Whop's docs say to run it on your own server and never ship it inside the app.
Will my Gumroad keys stop working when I cancel a buyer's Gumroad membership?
Gumroad keeps the key enabled until you disable it. Once the membership ends, its verify response fills in subscription_cancelled_at. If your software locks keys on that field, give the buyer their Whop key before their Gumroad period ends.
What about multi-seat Gumroad licenses?
Whop's software docs describe one key per membership, bound to one machine through a hardware ID you store, and no seat count. Before you send claim links, decide how you'll honor extra seats, for example by tracking seats per key on your own server.
Does MoveToWhop move license keys?
No. MoveToWhop moves your products and prices and creates the claim links your past buyers use to join Whop. It doesn't move or use your keys. Each claim creates a Whop membership, and Whop issues the new key.
Sources
Last updated . Prices and fees checked . Plans change, so confirm on the official page before you buy.
- 1.Gumroad Help: License keys, verify API, browser calls, multi-seat keys, cancelled memberships (checked 2026-10-14)gumroad.com
- 2.Gumroad Help: The sales analytics dashboard, License Key columns in the sales CSV (checked 2026-10-14)gumroad.com
- 3.Gumroad source code: sales export columns (checked 2026-10-14)github.com
- 4.Gumroad Help: The sales dashboard, managing license keys (checked 2026-10-14)gumroad.com
- 5.Gumroad Help: Delete or unpublish a product (checked 2026-10-14)gumroad.com
- 6.Whop Docs: SaaS, license key integration with the Software app (checked 2026-10-14)docs.whop.com
- 7.Whop Docs: Memberships, created at checkout (checked 2026-10-14)docs.whop.com
What changed
- First published. Gumroad's license key rules and verify API and Whop's Software app and key validation docs checked on October 14, 2026.
Keep reading
Related guides and comparisons
Gumroad to Whop
Moving from Gumroad to Whop? Members re-subscribe since Gumroad is merchant of record; past buyers get free claim links. See what moves, license keys and fees.
Export Gumroad customers
Gumroad's sales export starts at the last month, dates every row in UTC and lists each renewal on its own line. Export customers and subscribers the right way.
Gumroad members, no double billing
Gumroad renews each member on the day of the month they first paid, and you can't move that date. Line up Whop trials with it, then cancel members on Gumroad.
Whop vs Gumroad
Whop vs Gumroad: a $50 sale costs $7.25 in Gumroad fees and $1.65 on Whop. Compare yearly fees, Discover's 30%, payouts, tax handling and when Gumroad wins.
Gumroad Fees
Gumroad takes 10% + 50¢ per direct sale plus 2.9% + 30¢ card processing, and 30% on Discover sales. See every fee, payout costs and worked examples for 2026.
Gumroad alternatives
Gumroad alternatives scored on monthly fees, Gumroad features covered, sales tax and lock-in: Payhip, Lemon Squeezy, Whop, Podia, Stan Store, Shopify and Etsy.
Bet on yourself. Move to Whop.
Free migration. Takes minutes. Keep your members, courses and revenue.