SuperAPI AI 工具集

paddle-sandbox-testing

测试与质量

查看项目

更新于 10-16 03:14

技能介绍

用途:在正式上线前验证 Paddle 集成,运行看似真实的结账、触发 Webhook 事件并演练订阅状态变化,全程不产生真实收款。适合与结账、Webhook、订阅同步等技能配合使用。

主要能力:覆盖沙箱配置、测试卡号、Webhook 模拟器(单事件与场景)、本地公网隧道开发,以及沙箱与生产行为的差异。沙箱与生产环境完全隔离:API 基址分别为 sandbox-api.paddle.com 与 api.paddle.com,仪表盘、API 密钥、客户端令牌、通知目标、产品/价格/客户均各自独立,沙箱仅接受测试卡,调整/退款自动批准,税费只计算不收取,域名无需审批。

使用方式:在 sandbox-vendors.paddle.com 注册沙箱,创建产品与价格,在 Developer tools > Authentication 创建客户端令牌与服务端 API 密钥,并设置环境变量,例如 NEXT_PUBLIC_PADDLE_ENV=sandbox、NEXT_PUBLIC_PADDLE_CLIENT_TOKEN=test_...、PADDLE_API_KEY=pdl_sdbx_apikey_...、PADDLE_NOTIFICATION_WEBHOOK_SECRET=pdl_ntfset_...。沙箱密钥前缀为 pdl_sdbx_apikey_,生产为 pdl_live_apikey_。测试卡如 4242 4242 4242 4242(无 3DS)、4000 0038 0000 0446(含 3DS)、4000 0000 0000 0002(拒付)、4000 0027 6000 3184(首期成功后续续费失败)。Webhook 模拟器位于 Developer tools > Simulations,可选单事件或场景(如 subscription_created、subscription_renewed、subscription_canceled),设置通知目标 URL 后可发送,签名使用目标密钥,正常验证代码无需改动。真实流程可用隧道,如 hookdeck listen 3000,并将沙箱通知目标更新为隧道 URL。

适用场景与限制:用于上线前捕获集成缺陷,覆盖失败路径与边缘状态。需注意沙箱与生产密钥不可混用,生产初始化 Paddle.js 时环境参数须为 production,隧道重启后需更新通知目标 URL,各环境各目标密钥不同。资料未提供具体收费与价格信息。