SuperAPI AI 工具集

sales-paddle

营销与增长

查看项目

更新于 10-16 08:44

技能介绍

用途:Paddle 是面向 SaaS、应用和数字产品的 Merchant of Record(MoR)计费平台,提供本地化结账、订阅与全球税务处理。本技能用于解答 Paddle 平台的集成与使用问题。

主要能力:支持构建 API 集成(创建产品/价格、管理订阅与交易、拉取报表)、设置并验证 webhook(HMAC-SHA256)以开通访问或执行催收、从旧版 Paddle Classic API 迁移到 Paddle Billing、理解 MoR 模式(费用 5% + $0.50、代扣税务、结算周期),以及排查金额错误、webhook 乱序/重复、签名失败等问题。

使用方式:新集成一律基于 Paddle Billing(api.paddle.com),使用 Bearer 密钥;开发先在 sandbox-api.paddle.com 与独立密钥上进行。金额为最小货币单位的字符串,如 unit_price.amount = "2000" 表示 $20.00,并需设置正确的 tax_category。Webhook 需验证 Paddle-Signature,按 occurred_at 排序处理,并按 event_id 去重,同时定期通过 API 对账。

适用场景:订阅开通与权限发放、价格创建、MRR 同步、Classic 迁移、MoR 费用与结算理解。

限制:Paddle Classic 与 Paddle Billing 是互不兼容的两个产品;webhook 投递顺序不保证且可能重投;Paddle 作为 MoR 负责税务计算与缴纳及结算,非即时到账;sandbox 与生产环境完全分离。跨服务商选型(如 Paddle vs Lemon Squeezy)属于策略问题,应路由到 /sales-merchant-of-record。