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

