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
Paddle Docs home

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

Paddle Billing offers a modernized billing platform with multi-product subscriptions, unified product catalogs, advanced pricing controls, and a redesigned API and developer experience compared to Paddle Classic.

  • โ€ขBuild flexible billing models with multi-product subscriptions, price localization by country, and unified discount management across one-time and recurring charges
  • โ€ขStreamline customer management through a centralized customer entity, customer portal for self-service, and support for modular customer data like multiple addresses and businesses
  • โ€ขAccess complete billing operations through a modern REST API, TypeScript-enabled Paddle.js v2, multiple SDKs, and 50+ lifecycle webhooks that mirror API responses

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-timeSubscriptions
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-timeSubscriptionsInvoice
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.

InvoiceOne-timeSubscriptions

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. Deep link to a specific subscription, and present cancellation flows automatically when customers cancel.

One-timeSubscriptions
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-timeSubscriptions
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.

InvoiceOne-timeSubscriptions

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-timeSubscriptions
Express checkout

Lead with one-click payment methods like Apple Pay and Google Pay, so customers on mobile can pay without filling in a checkout form.

One-timeSubscriptions
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-timeSubscriptionsInvoice
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
Free, paid, and cardless trials

Increase conversion with flexible trials. Offer free trials with a card required, cardless free trials, or charge a reduced amount for a trial period. Cardless trials are in early access.

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
Built-in integration with Retain

Paddle Retain handles dunning and retention for you, combining subscription expertise and algorithms to recover failed payments, 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.

InvoiceOne-timeSubscriptions
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
Reports for every part of your business

Export reports for transactions, adjustments, discounts, checkout conversion, subscriptions, and payout reconciliation to use in accounting software, ERPs, and business intelligence tools.

InvoiceOne-timeSubscriptions
Metrics and Explore

Get timeseries data like MRR, active subscribers, and revenue using the Paddle API, or filter and break down your data in Explore in the Paddle dashboard.

InvoiceOne-timeSubscriptions
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.

InvoiceOne-timeSubscriptions

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.

InvoiceOne-timeSubscriptions
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 it in the API. You have complete access to your data โ€” including customers, catalog, transactions, and metrics.

InvoiceOne-timeSubscriptions
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-timeSubscriptions
SDKs, components, and starter kits

Use hand-crafted SDKs for Node.js, Python, Go, and PHP, drop Paddle UI React components into your app, or start from a Next.js starter kit to get up and running quickly.

InvoiceOne-timeSubscriptions
Build with AI

Connect AI agents to your account using the Paddle MCP server. Install agent skills and plugins for Claude Code, Codex, and Cursor, and use the docs MCP server to give agents up-to-date Paddle knowledge.

InvoiceOne-timeSubscriptions
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-timeSubscriptions
More robust webhooks

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

InvoiceOne-timeSubscriptions

Was this page helpful?