How to migrate from Lemon Squeezy to Paddle
Paddle is the longest-running merchant of record for software. It's strong on subscriptions, invoicing and B2B checkout.
Updated November 2026 · Lemon Squeezy stops processing payments March 31, 2027
Paddle is a good fit if
- — Subscription SaaS with growing B2B revenue
- — You need invoicing and purchase-order style sales
- — You want a mature, well-documented Billing API
Check first
- — Seller onboarding includes a domain and product review, so start early
- — No built-in license keys in Paddle Billing; plan your own key service
- — Webhook payloads differ a lot from Lemon Squeezy, so budget time for handler rewrites
Why sellers pick Paddle
Paddle has been a merchant of record for software companies far longer than Lemon Squeezy existed. It's strongest for subscription SaaS, and especially for B2B customers who need proper invoices, tax receipts and purchase-order style payments. Its Billing API is mature and well documented.
Mapping your catalog
| Lemon Squeezy | Paddle Billing |
|---|---|
| Product | Product |
| Variant | Price (billing cycle and trial live on the Price) |
| Subscription | Subscription |
| Order | Transaction |
| Discount code | Discount |
| Customer | Customer (+ Address, Business for B2B) |
| License key | Not built in. Run your own key service |
| Affiliates | Third-party tool |
Paddle Prices carry the billing cycle and trial period, so a Lemon Squeezy variant with a 7-day trial billed monthly becomes one Paddle Price with billing_cycle of 1 month and trial_period of 7 days. Use custom_data on the Price to store the old variant ID.
Get approved early
Paddle reviews your website and products before you can take live payments. They check things like a clear pricing page, terms, a refund policy and that what you sell is allowed. Apply in week one, while you're still exporting data, so approval isn't the thing that holds you up.
Swapping checkout
Paddle uses Paddle.js for an overlay or inline checkout, similar to the Lemon Squeezy overlay:
<script src="https://cdn.paddle.com/paddle/v2/paddle.js"></script>
<script>
Paddle.Initialize({ token: "live_..." });
function buy() {
Paddle.Checkout.open({
items: [{ priceId: "pri_...", quantity: 1 }],
customer: { email: currentUser.email },
customData: { user_id: currentUser.id }, // replaces Lemon Squeezy custom_data
});
}
</script>
Moving subscriptions to Paddle
If your subscribers' payment methods can be moved to Paddle through a secure transfer, Paddle can import them and you recreate each subscription with the right price and next billing date. Talk to Paddle about migration support early. If a transfer isn't possible, run the re-subscribe playbook: pre-filled checkouts with billing deferred to each customer's renewal date.
Webhooks
Paddle's events are structured differently from Lemon Squeezy's. Recurring payments arrive as transaction.completed events tied to a subscription_id, and subscription lifecycle changes arrive as subscription.* events. Verify the Paddle-Signature header (the SDK's webhooks.unmarshal does it). Full mapping: webhook migration guide.
License keys on Paddle
Paddle Billing has no built-in license keys. Generate keys in your own service when transaction.completed arrives, and keep validation on your own domain. See migrating license keys.
Typical timeline
| Week | Work |
|---|---|
| 1 | Export, apply to Paddle, ask about payment-method transfer |
| 2 | Catalog, Paddle.js checkout, webhook handlers in sandbox |
| 3 | License key service, affiliates, approval follow-ups |
| 4–6 | Subscription migration, staged cutover, customer emails |
Webhook mapping: Lemon Squeezy → Paddle
Closest equivalents. Check payload shapes against Paddle's current docs before shipping. Signature code for every provider →
| Lemon Squeezy | Paddle |
|---|---|
| order_created | transaction.completed |
| subscription_created | subscription.created |
| subscription_updated | subscription.updated |
| subscription_payment_success | transaction.completed (with subscription_id) |
| subscription_cancelled | subscription.canceled |
| license_key_created | none: issue keys from your own service |
Don't want to do this yourself? We'll do the whole migration at a fixed price.
Questions
How long does a Lemon Squeezy to Paddle migration take?+−
A store with only one-time products can move in a few days. With active subscriptions, license keys or affiliates, plan for two to five weeks including testing and a staged cutover.
Can I move my subscribers to Paddle without them re-entering their card?+−
Only if a secure payment data transfer between Lemon Squeezy/Stripe and Paddle is approved for your account. Ask both sides early. If it isn't possible, a well-run re-subscribe flow keeps most subscribers.
Is Paddle a merchant of record like Lemon Squeezy?+−
Yes. Paddle handles sales tax and VAT as merchant of record. Confirm it supports your seller country and product type.
Does Paddle support license keys?+−
Not natively. You'd run your own key service fed by Paddle webhooks and keep validation on your own domain.