开始之前
请确保您已备好:API凭证
用于身份验证的有效 API 凭据和访问令牌。
账户设置
为您的目标国家/地区正确设置账户并进行业务验证。
IP白名单
将服务器 IP 地址加入 API 访问白名单。
Webhook endpoint
设置 webhook URL 以接收付款通知。
步骤 1:更新订阅
要修改现有订阅,请向更新订阅endpoint 发送PATCH 请求。
关键请求参数
该请求需要几个关键参数:示例请求
以下是使用curl 的示例:
curl
步骤 2:处理响应
成功响应
更新成功后将返回修改后的订阅详情:关键响应字段
错误响应
请求失败时,您将收到详细的错误信息:步骤 3:跟踪交易状态
更新订阅后,可通过以下方式监控其状态:Webhooks(推荐)
交易状态变更时接收实时通知。最适用于生产环境。
状态 API endpoint
以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。
Business Portal 视图
用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。
常用状态码
Localpayment API 提供各种状态代码,以在响应中指示付款的进度和结果。完整参考请查看我们的交易状态文档,了解所有状态代码。
测试您的集成
测试场景
请确认您的集成方案能够处理以下场景:- 成功升级套餐:提高订阅等级或金额。
- 成功降级套餐:降低订阅等级或金额。
- 支付方式更新:更改银行卡详情。
- 客户信息更新:修改客户详情。
- 验证错误:金额无效、缺少必填字段。
- 状态更新:Webhook 处理和状态轮询
后续步骤
更新订阅后,您可能需要执行其他操作:取消订阅
当更新不足以满足需求时,终止有效订阅。
处理订阅 Webhook
设置 Webhook 以接收订阅更新事件的通知。
创建订阅计划
创建可在更新订阅时使用的新计划。

