For AI agents and LLMs: a structured documentation index is available at /llms.txt. Every page has a Markdown sibling — append .md to any URL.

Skip to content
Docs

Key features in Paddle Billing for Paddle Classic users

Learn more about what you can do with Paddle Billing and why you should migrate from Paddle Classic.

AI summary

An overview of the key reasons to migrate from Paddle Classic to Paddle Billing, covering expanded product catalog flexibility, richer customer data, improved subscription workflows, better reporting, and a modern developer platform.

  • • The product catalog in Paddle Billing supports multi-item subscriptions, non-catalog items, and per-unit discounts — none of which are available in Classic.
  • • Customers in Paddle Billing have separate address and business entities, supporting multiple subscriptions per customer and tax-exempt billing for VAT/GST-registered businesses.
  • • The developer experience includes a unified REST API, hand-crafted SDKs, TypeScript support, public OpenAPI spec, and a customer portal with API-generated session links.

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.

This guide is an overview of the key reasons to migrate from Paddle Classic to Paddle Billing. It helps you understand some of the things you'll be able to do after you've migrated.

What are you migrating?

Pick all that apply — content updates to match.

Product catalog

Multi-product subscriptions

Paddle Billing supports multi-product subscriptions, letting you build complex offerings including plans, recurring addons, and one-time charges on the same subscription.

Subscriptions
Unified product catalog

No need to duplicate data. Create invoices for the same products that you offer at checkout, changing the price as you move through the sales cycle. Issue compliant invoices when you're ready.

Invoice
True price localization

Price for countries, not currencies. Use price overrides to adjust for willingness-to-pay and purchasing power — even across countries that share the same currency.

One-time Subscriptions
Flexible discounting

Coupons, modifiers, and charges have become a unified discount entity in Billing. Choose how long discounts recur for, apply them to subscriptions, and limit at checkout.

One-time Subscriptions Invoice
Bring your own catalog

Pass products and prices directly to a subscription, checkout, or invoice to bill for one-off items, or in cases where you manage your catalog outside of Paddle.

Invoice One-time Subscriptions

Customers

Plug in the customer portal

Let customers grab and revise invoices, update their account details, and manage their own subscriptions using the customer portal. No engineering effort required.

One-time Subscriptions
Manage customers yourself

Customer information is centralized in a lightweight customer entity that's specific to your Paddle Billing account. You have full access to customer data using the dashboard and API.

One-time Subscriptions
Modular customer data

A single customer can have multiple addresses and businesses — useful when you're dealing with a large customer with offices in different locations.

Invoice One-time Subscriptions

Billing and subscriptions

One-page checkout

Present customers with a true one-page checkout experience, collecting customer, address, business, and billing details on one screen.

One-time Subscriptions
Hybrid billing

Sell through a checkout or issue invoices — all from the same integrated platform. Easily move customers from self-serve to sales-assisted billing, with payments by bank transfer.

One-time Subscriptions Invoice
Automatic subscription invoices

Create invoices for recurring products. Paddle Billing automatically sends invoices for subscription lifecycle events, like renewals, upgrades and downgrades, and other charges.

Invoice
Preview charging

Preview charging for actions like upgrading or downgrading, adding or removing addons, changing billing dates, billing one-time charges, or making other changes to a subscription.

Subscriptions
Full control over trials

Trialing subscriptions behave like other subscriptions, so you can upgrade, downgrade, or add or remove items. Plus, extend or cut short trial dates, or activate immediately.

Subscriptions
Advanced pause and resume

Get more control over how pausing and resuming subscriptions works — including setting a resume date and choosing whether to charge for a new billing cycle.

Subscriptions
Seamless integration with Retain

Never think about dunning or retention again. Retain combines world-class subscription expertise and algorithms to automatically reduce churn and increase lifetime value.

Subscriptions

Finance and reporting

Automatic invoicing emails

Add contacts to a business for people in accounts or finance teams. Paddle Billing automatically emails business contacts when an invoice is issued, paid, or canceled.

Invoice
Generate credit notes

Use adjustments to refund or credit a transaction. Grab a credit note, sometimes called a credit memo in other platforms, to send to customers as a record of a refund or credit.

Invoice One-time Subscriptions
Faster invoice reconciliation

When you send invoices, Paddle Billing generates unique bank transfer account numbers for each customer. This means invoices can be reconciled faster.

Invoice
Better reporting

By unifying catalog and customers with checkout and invoices, Paddle Billing lets you report on invoicing revenue in the context of all your business data.

Invoice
Revise customer details on completed purchases

Let customers update their tax number, address, or other information on completed invoices and checkouts. The original transaction remains unchanged for compliance.

Invoice One-time Subscriptions

Developer experience

A totally new API

Paddle Billing includes a new unified REST API that brings together all your billing operations. It's consistent and built to modern standards, with JSON for requests and responses.

Invoice One-time Subscriptions
Full access to all your data

Our public API powers the dashboard, so if you can do it in the dashboard, then you can do in the API. You have complete access to your data — including customers, catalog, and transactions.

Invoice One-time Subscriptions
Paddle.js v2

A new version of Paddle.js makes it easier to work with Paddle in your frontend. Plus, install Paddle.js as a module using npm or other package managers, with full TypeScript support.

One-time Subscriptions
New SDKs and developer tools

Use our hand-crafted SDKs to make integrating a pleasure, our Next.js starter kit to get up and running quickly, and our MCP server to bring Paddle into AI-powered IDEs.

Invoice One-time Subscriptions
Advanced webhook testing

Go beyond sending a test event to your webhook endpoint. Use webhook simulator to send customized multi-event scenarios, playing out all webhooks for key lifecycle events.

One-time Subscriptions
More robust webhooks

Built around a centralized event stream, there are over 40 webhooks for the entire customer lifecycle. Payloads mirror API responses, with the ability to configure multiple endpoints.

Invoice One-time Subscriptions

Was this page helpful?