跳转到主要内容
Localpayment 支持您修改现有订阅,以适应客户需求的变化,例如升级或降级套餐、更新账单信息或更改订阅频率。本指南详细介绍了通过 Localpayment API 更新订阅的流程。

开始之前

请确保您已备好:

API凭证

用于身份验证的有效 API 凭据和访问令牌。

账户设置

为您的目标国家/地区正确设置账户并进行业务验证。

IP白名单

将服务器 IP 地址加入 API 访问白名单。

Webhook endpoint

设置 webhook URL 以接收付款通知。

步骤 1:更新订阅

要修改现有订阅,请向更新订阅endpoint 发送 PATCH 请求。

关键请求参数

该请求需要几个关键参数:

示例请求

以下是使用 curl 的示例:
curl
查看请求中所有可用的参数。

步骤 2:处理响应

成功响应

更新成功后将返回修改后的订阅详情:

关键响应字段

错误响应

请求失败时,您将收到详细的错误信息:

步骤 3:跟踪交易状态

更新订阅后,可通过以下方式监控其状态:

Webhooks(推荐)

交易状态变更时接收实时通知。最适用于生产环境。

状态 API endpoint

以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。

Business Portal 视图

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

常用状态码

Localpayment API 提供各种状态代码,以在响应中指示付款的进度和结果。
完整参考请查看我们的交易状态文档,了解所有状态代码。

测试您的集成

测试场景

请确认您的集成方案能够处理以下场景:
  1. 成功升级套餐:提高订阅等级或金额。
  2. 成功降级套餐:降低订阅等级或金额。
  3. 支付方式更新:更改银行卡详情。
  4. 客户信息更新:修改客户详情。
  5. 验证错误:金额无效、缺少必填字段。
  6. 状态更新:Webhook 处理和状态轮询

后续步骤

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

取消订阅

当更新不足以满足需求时,终止有效订阅。

处理订阅 Webhook

设置 Webhook 以接收订阅更新事件的通知。

创建订阅计划

创建可在更新订阅时使用的新计划。
最后修改于 2026年11月10日