Paddle Billing

Migrate from Paddle Classic to Paddle Billing

Understand what Paddle Billing is, how it compares to Paddle Classic, and learn more about how the migration process works.

If you signed up for Paddle before August 8th, 2023 then you have Paddle Classic. We released a new version of Paddle called Paddle Billing. It's built on the Paddle platform, but includes a totally new API, webhooks, JavaScript library, and pages in the Paddle Billing web app.

This guide is for Paddle Classic customers who want to move to Paddle Billing. It explains what Paddle Billing is, how it compares to Paddle Classic, and what you'll need to do if you want to migrate.

Porting subscription data from Paddle Classic to Paddle Billing is in early access.

What is Paddle Billing?

Paddle Billing is a new set of billing and recurring revenue management features designed for modern SaaS and digital product businesses. It gives you new ways to increase your revenue, retain customers, and scale your operations compared to Paddle Classic. You can think of it is an entirely new version of Paddle.

It shares the same world-class merchant of record foundations as Paddle Classic, meaning it comes with everything you need for payments and tax. Fraud prevention, global tax calculation and remittance, plug and play payment methods, a high performance checkout experience, and access to over 200 countries comes as standard with Paddle Billing.

What can you do with Paddle Billing?

Paddle Billing is a reimagining of how you work with the Paddle platform, offering you more ways to maximize revenue and grow your sales volume.

How do you get Paddle Billing?

All Paddle Classic customers can activate Paddle Billing to get access to the new API, webhooks, and pages in the Paddle web app. Paddle Billing has a separate set of data, so you won't lose any data in Paddle Classic when you turn on Paddle Billing. It doesn't cost anything until you start running transactions through it.

Once activated, your Paddle Classic integration continues to work as before. To move to Paddle Billing, you need to build an integration with our new platform and migrate your Classic data.

Here's how the process works at a high level:

  1. Activate Paddle Billing and build an integration.

    Turn on Paddle Billing for your account, then build an integration using our new API, webhooks, and Paddle.js v2. We have SDKs for PHP and Node.js, plus a new version of Laravel Cashier to speed up the process.

  2. Start transacting through Paddle Billing.

    When you're ready, start selling using Paddle Billing. Create and manage new subscriptions using Paddle Billing, while running existing subscriptions through Paddle Classic.

  3. Migrate Classic subscriptions to Billing.

    Request a migration and let our team port your existing customers and subscriptions from Paddle Classic to Paddle Billing. Webhooks occur when records are migrated, so you're kept in-the-loop.

  4. Turn off your Classic integration.

    You're done! You can remove Paddle Classic from your stack and use Paddle Billing.

What happens to your Paddle Classic data and integration?

Paddle Billing and Paddle Classic have separate sets of data. Once you've activated Paddle Billing, you get access to a toggle that lets you switch between your Paddle Classic and Paddle Billing data.

Screenshot showing a Paddle dashboard that's opted in to Paddle Billing. There is a toggle at the bottom-right, which has been called out. The toggle has options for Paddle Classic and Paddle Billing, and Paddle Billing is selected.


Core settings are shared between Paddle Classic and Paddle Billing, but data is separate. This means:

  • Your Paddle Classic data is safe. Nothing happens to existing subscriptions or other data in Paddle Classic.
  • Your Paddle Classic integration isn't impacted. Customers can still make purchases using your existing integration.
  • You get a new set of data for Paddle Billing, but no data is migrated automatically. Pages for customers, products, subscriptions, and other entities in Paddle Billing are empty initially. This data still exists in Paddle Classic.

Your existing integration will continue to work as before. Existing customer and subscription data is not ported over automatically or changed in any way. For example, customers can continue to buy things using your existing integration and subscriptions in Paddle Classic aren't created in Paddle Billing.

When you migrate to Paddle Billing from Paddle Classic, historic reporting data is not ported over. You can always switch to Paddle Classic using the toggle to work with your historic data.

Next steps

If you'd like to migrate, we're here to help throughout the process. To start, continue reading our migration guides. Our guides walk you through:

  • What's new or changed in Paddle Billing, in detail
  • How data in Paddle Classic maps to data in Paddle Billing
  • Technical differences between Paddle Classic and Paddle Billing
  • How to build an integration and plan for a migration