用途:Paddle 是面向 SaaS 的商户记录(Merchant of Record)平台,负责处理支付、税费与合规,适合销售 SaaS 订阅、搭建结账浮层与定价页。
主要能力:前端 Paddle.js 支持打开结账、内联结账、传入客户与自定义数据、监听结账事件、更新或关闭结账、价格预览(含本地化与税费);服务端 Node.js SDK 支持产品与价格管理、订阅的查询/更新/暂停/恢复/取消、生成更新支付方式链接、交易与发票 PDF、客户管理,以及 Webhook 签名校验与事件处理(订阅创建/更新/取消、交易完成、支付失败等)。还提供 Paddle Retain 取消流程以减少流失。
使用方式:前端引入 https://cdn.paddle.com/paddle/v2/paddle.js 并调用 Paddle.Initialize 传入客户端 token,再用 Paddle.Checkout.open 打开结账;服务端执行 npm install @paddle/paddle-node-sdk,用 API Key 初始化 Paddle 实例,可指定 Environment.sandbox 或 Environment.production。Webhook 需用原始请求体与 paddle-signature 头做签名校验。
适用场景:SaaS 订阅计费、定价页与结账集成、订阅生命周期管理、发票与交易记录、流失预防。
限制:资料未提供具体收费、价格、平台支持范围与效果数据;前端不得暴露 API Key,应使用客户端 token;Webhook 必须服务端校验签名;开发建议使用 sandbox 环境。