Paddle Billing is a complete digital product sales and subscription management platform, designed for modern software businesses. It helps you increase your revenue, retain customers, and scale your operations.
You can use Paddle.js to integrate Paddle Checkout and Paddle Retain with your app or website.
This package is a wrapper for Paddle.js that lets you:
- Download and work with Paddle.js
- Use TypeScript definitions when working with Paddle.js functions
Important: This package works for Paddle.js v2, which is part of Paddle Billing. It does not support Paddle Classic. To work with Paddle.js v1, see: Paddle.js v1 reference
Install using npm:
npm install @paddle/paddle-jsInstall using yarn:
yarn add @paddle/paddle-jsInstall using pnpm:
pnpm add @paddle/paddle-jsImport, then use the initializePaddle function to initialize Paddle.js. It downloads Paddle.js from the CDN, then initializes it using the seller ID, environment, and any other settings that you passed.
For security and compliance, you must only load Paddle.js directly from https://cdn.paddle.com/. This makes sure that you're running with the latest security and feature updates from Paddle.
Note:
initializePaddlealways downloads the latest version of Paddle.js. Updates to this package are for the loader or TypeScript definitions, and may not be tied to updates for Paddle.js.
This package includes TypeScript definitions for Paddle.js. The minimum supported version of TypeScript is 4.1.
For example, CheckoutOpenOptions has definitions for all the values you can pass to the Paddle.Checkout.open() method in Paddle.js.
This is a simple React example that shows how to import, initialize, and open a checkout with one item.
import { initializePaddle, Paddle } from '@paddle/paddle-js';
export function Checkout() {
// Create a local state to store Paddle instance
const [paddle, setPaddle] = useState<Paddle>();
// Download and initialize Paddle instance from CDN
useEffect(() => {
initializePaddle({ environment: 'ENVIRONMENT_GOES_HERE', token: 'AUTH_TOKEN_GOES_HERE' }).then(
(paddleInstance: Paddle | undefined) => {
if (paddleInstance) {
setPaddle(paddleInstance);
}
},
);
}, []);
// Callback to open a checkout
const openCheckout = () => {
paddle?.Checkout.open({
items: [{ priceId: 'PRICE_ID_GOES_HERE', quantity: 1 }],
});
};
}