开始之前
请确保您已备好:API凭证
用于身份验证的有效 API 凭据和访问令牌。
账户设置
为您的目标国家/地区正确设置账户并进行业务验证。
IP白名单
将服务器 IP 地址加入 API 访问白名单。
Webhook endpoint
设置 webhook URL 以接收付款通知。
第一步:创建订阅计划
要创建新的订阅计划,请向创建订阅计划endpoint 发送POST 请求。
关键请求参数
该请求需要几个关键对象:支持的计费频率
每日
每日向客户收费。非常适合每日使用量大或
短期使用的服务。发送
autoRecurring.type 属性,值为:day月度
适用于大多数 SaaS 产品、会员服务和
订阅盒的按月定期计费。发送
autoRecurring.type 属性,值为:month定制(按需)
适用于使用量不固定场景的按需计费。非常适合
按量付费或基于使用量的服务。发送
autoRecurring.type 属性,值为:custom示例请求
以下是使用curl 的示例:
curl
步骤 2:处理响应
成功响应
成功创建的订阅计划将显示完整的计划详情:关键响应字段
错误响应
订阅计划创建失败时,您将收到详细的错误信息:步骤 3:跟踪交易状态
创建订阅计划后,可通过以下方法监控其状态:Webhooks(推荐)
交易状态变更时接收实时通知。最适用于生产环境。
状态 API endpoint
以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。
Business Portal 视图
用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。
常用状态码
完整参考请查看我们的交易状态文档,了解所有状态代码。
测试您的集成
测试场景
请确认您的集成方案能够处理以下场景:- 计划创建成功:使用有效参数创建标准计划。
- 分级定价结构:创建多个不同价位的套餐。
- 多种计费频率:测试每日、每月和自定义按需计划。
- 验证错误:缺少必填字段、金额无效、国家/地区不受支持。
- 订阅关联:测试计划能否成功与订阅关联
后续步骤
创建订阅计划后,您可能需要执行其他操作:使用计划创建订阅
将计划的 internalId 用作 planId 参数,
使用您的新计划创建客户订阅。
更新订阅计划
修改现有计划详情,同时保持与
有效订阅的关联。

