跳转到主要内容
Localpayment 允许您在客户不再希望继续支付定期款项时取消有效订阅。本指南详细介绍了通过 Localpayment API 取消订阅的流程,包括立即取消和账单周期结束时取消的选项。

开始之前

请确保您已备好:

API凭证

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

账户设置

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

IP白名单

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

Webhook endpoint

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

第一步:取消订阅

要取消现有订阅,请向取消订阅endpoint 发送 PATCH 请求。

关键请求参数

该请求需要几个关键对象:

示例请求

以下是使用 curl 的示例:
curl
重要的订阅一旦取消,便无法重新激活。如果客户希望恢复服务,您需要创建新的订阅。

步骤 2:处理响应

成功响应

成功取消订阅后,系统会返回订阅取消确认信息:

关键响应字段

错误响应

订阅取消失败时,您将收到错误信息::

步骤 3:跟踪交易状态

取消订阅后,可通过以下方式监控订阅状态:

Webhooks(推荐)

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

状态 API endpoint

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

Business Portal 视图

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

常用状态码

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

测试您的集成

测试场景

请确认您的集成方案能够处理以下场景:
  1. 成功取消:使用有效凭证取消有效订阅。
  2. 已取消的订阅:尝试取消已取消的订阅。
  3. 取消不存在的订阅:取消一个不存在的订阅。
  4. 身份验证错误:如果身份验证无效或缺失,则取消。
  5. Webhook 通知:确认取消 Webhook 已触发

后续步骤

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

创建新订阅

如果客户希望使用不同的方案或付款方式恢复服务, 请创建新订阅。

设置 Webhook

配置 Webhook 以接收订阅事件的实时通知。
最后修改于 2026年11月10日