Paddle 接入说明
接入 Paddle 所需配置
1. BytePower Console 配置
在 BytePower Console 上完成以下配置：
- Paddle 平台配置
- Paddle 商品配置
2. Paddle 后台配置
在 Paddle 后台配置 Notification，notification URL 形如：
https://{host_name}/bp/server/paddle/callback其中 host_name 是 BytePower Console 上对应的 App 域名。
Paddle Sandbox 环境配置地址：
订阅购买过程
步骤 1：拉取商品配置
使用 bp/asset/product_configs API 拉取商品配置。
步骤 2：获取客户信息（可选）
如果需要对已经购买过的用户采用免输入支付方式进行购买：
- 调用
bp/asset/{platform}/customers接口获取该用户所有的 customers 以及 token - 使用 token 获取 customer 已有的支付方式并进行支付
参考文档：Paddle Saved Payment Methods
注意
如果用户使用多个 email 进行过多次购买，那么该用户可能会存在多个 customers。
步骤 3：创建订阅
在配置中选择要购买的商品，调用 POST /bp/asset/{platform}/subscription 创建订阅。
步骤 4：前端创建交易
在前端创建 Paddle 交易并付费，并将第 3 步返回的 bp_sub_id 添加到 custom data 中。
步骤 5：同步充值结果（可选）
购买成功后，调用 POST /bp/asset/{platform}/subscription/sync 接口同步充值结果。
关于 Sync 接口
第 5 步 sync 接口的调用是可选的，用于实时获取充值结果。
不调用的话，BytePower 也可以接收 Paddle 的 webhook 进行充值，不过这样可能会有一些延迟。
其它 API
完整的 API 文档请参考：Paddle API 文档
按需调用以下 API：
- 变更 Product
- 取消订阅
- 退款
- 其它订阅管理操作
带付费试用期的套餐配置示例
使用场景
Paid trial setup - 例如：立即支付 $1，7 天后按 $20/月订阅
配置步骤
1. 在 Paddle Catalog 中创建产品
2. 创建主订阅价格
点击 + New Price 并设置：
- Base price: 例如 20 USD
- Type: Recurring
- Billing period: Monthly
- Trial period: 7 Days
点击 Save 保存。
3. 创建付费试用价格
点击 + New Price 并设置：
- Base price: 例如 1 USD
- Type: One-time
点击 Save 保存。
4. 在前端集成
在买家进入结账页面时，将两个 price_id 传递给 Paddle.Checkout.open() 的 items 数组中。
5. 结账流程
结账时会向买家收取 $1 的费用，并生成一个 $20/月的试用订阅，试用期结束后自动开始计费。