跳转到主要内容
Localpayment 允许您修改现有订阅计划,以适应定价策略、账单周期或服务内容的变更。本指南详细介绍了如何通过 Localpayment 的 API 更新订阅计划,确保现有订阅能够按照新条款或您配置的策略继续有效。

开始之前

请确保您已备好:

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 视图

用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。

常用状态码

完整参考请查看我们的交易状态文档,了解所有状态代码。

测试您的集成

测试场景

请确认您的集成方案能够处理以下场景:
  1. 金额更新成功:使用有效的金额值修改计划价格。
  2. 计费频率变更:从每月计费更新为每日计费或自定义计费。
  3. 部分更新:仅修改特定字段,无需发送完整数据。
  4. 验证错误:使用无效金额、缺少必填字段或不支持的频率进行测试。
  5. 不存在的计划:尝试更新一个不存在的计划。
  6. 身份验证失败:使用无效或过期的访问令牌进行测试。

后续步骤

更新订阅计划后,您可能需要执行其他操作:

创建新的订阅计划

为不同的价格等级或服务等级设置额外的订阅计划。

使用更新后的计划创建订阅

使用更新后的套餐创建新的订阅来测试更改。

获取订阅计划详情

获取更新后的计划信息,以核实所有变更是否已应用。
最后修改于 2026年11月10日