Docs

The merchant of record for developers

We take care of payments, tax, subscriptions, and metrics with one unified API that does it all.
Get started
What is Paddle?

Built for subscriptions

Offer any billing model, and handle all of the subscription lifecycle.

Integrate in an afternoon

Hand-crafted SDKs and developer tools make integration a delight.

Automatic localization

Out-of-the-box support for 30 currencies across 200+ markets.

Fraud protection

Paddle prevents card attacks, fights chargebacks, and blocks fraudsters.

Intelligent dunning

Optimized payment retries and data-driven retention with Retain.

Popular payment methods

Accept card, digital wallets, and local payment methods in one-click.

See it in action

Build with Paddle

Open a checkout

Add a checkout to your app or website using Paddle.js to let customers buy one-time products and sign up for a subscriptions.

Paddle.Checkout.open({
  items: [
    { priceId: 'pri_01gm81eqze2vmmvhpjg13bfeqg', quantity: 1 },
    { priceId: 'pri_01gm82kny0ad1tk358gxmsq87m', quantity: 1 }
  ]
});

Present localized prices

Build pricing pages that show customers prices localized for their country and currency — including estimated taxes and discounts.

Paddle.PricePreview({
  items: [
    { priceId: 'pri_01gm81eqze2vmmvhpjg13bfeqg', quantity: 1 },
    { priceId: 'pri_01gm82kny0ad1tk358gxmsq87m', quantity: 1 }
  ],
  customerIpAddress: '8.29.228.32'
});

Upgrade a subscription

Add or remove recurring addons, move from month to annual, or switch plans by swapping out items. Choose to bill now or bill later, and use to-the-minute proration for fair billing.

await paddle.subscriptions.update("sub_01hv8y5ehszzq0yv20ttx3166y", {
  "items": [
    { "priceId": "pri_01gm81eqze2vmmvhpjg13bfeqg", "quantity": 20 },
    { "priceId": "pri_01gm82kny0ad1tk358gxmsq87m", "quantity": 1 },
  ],
  "prorationBillingMode": "prorated_immediately"
})

Enable payment methods

Turn on popular digital wallets and local payment methods in a couple of clicks. No need to sign up for multiple merchant accounts, and no additional code required.

CardCard
PayPalPayPal
Apple PayApple Pay
Card type
CVV
Hand-crafted SDKs and developer tools
Ship faster with SDKs for popular programming languages, plus developer tools for testing and integration.
Card, wallets, and local payment options
Add new payment methods in one-click, with built-in intelligent routing across acquirers for payment success.
Comprehensive webhooks
Build complex workflows, with webhooks for all parts of the customer, subscription, and invoice lifecycles.
One unified API for SaaS and apps
Plug in payments, localization, and subscription management with one unified API that does it all.

Developer changelog

An evolving platform

Integrate with a future-proofed platform, so you can focus on building your app and not your billing infrastructure.

Go to changelog

Sign up for developer updates

No marketing emails. Unsubscribe any time.

Developer blog

Latest blog posts

View all

Most visited docs

Popular guides

View all

@PaddleHQ on GitHub

Popular repos

View all