Paddle

Merchant of record with checkout, subscriptions, customer portal, and RSA webhook verification.

Installation

npm install billingsdk-core billingsdk-paddle

Configuration

import { paddle } from "billingsdk-paddle";

const adapter = paddle({
  apiKey: process.env.PADDLE_API_KEY!,
  webhookPublicKey: process.env.PADDLE_WEBHOOK_PUBLIC_KEY,
  environment: "production", // or "sandbox"
});

Find your API key in the Paddle Dashboard. For sandbox testing, set environment: "sandbox".

Capabilities

Checkout ✅

Subscriptions ✅

Customer Portal ✅

Subscription Pause ✅

Subscription Resume ✅

Refunds ✅

Webhook Verification

Uses RSA-SHA256 signature verification with Paddle's public key via the Paddle-Signature header. Configure your webhook URL and public key in the Paddle Dashboard.