跳转到主要内容
Localpayment 使您能够创建固定订阅计划,以实现标准化的周期性计费。本指南详细介绍了如何通过 Localpayment 的 API 设置订阅计划,然后将这些计划与客户订阅关联起来,从而实现一致的自动化计费。

开始之前

请确保您已备好:

API凭证

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

账户设置

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

IP白名单

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

Webhook endpoint

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

第一步:创建订阅计划

要创建新的订阅计划,请向创建订阅计划endpoint 发送 POST 请求。

关键请求参数

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

支持的计费频率

每日

每日向客户收费。非常适合每日使用量大或 短期使用的服务。发送 autoRecurring.type 属性,值为:day

月度

适用于大多数 SaaS 产品、会员服务和 订阅盒的按月定期计费。发送 autoRecurring.type 属性,值为:month

定制(按需)

适用于使用量不固定场景的按需计费。非常适合 按量付费或基于使用量的服务。发送 autoRecurring.type 属性,值为:custom

示例请求

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

步骤 2:处理响应

成功响应

成功创建的订阅计划将显示完整的计划详情:

关键响应字段

错误响应

订阅计划创建失败时,您将收到详细的错误信息:

步骤 3:跟踪交易状态

创建订阅计划后,可通过以下方法监控其状态:

Webhooks(推荐)

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

状态 API endpoint

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

Business Portal 视图

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

常用状态码

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

测试您的集成

测试场景

请确认您的集成方案能够处理以下场景:
  1. 计划创建成功:使用有效参数创建标准计划。
  2. 分级定价结构:创建多个不同价位的套餐。
  3. 多种计费频率:测试每日、每月和自定义按需计划。
  4. 验证错误:缺少必填字段、金额无效、国家/地区不受支持。
  5. 订阅关联:测试计划能否成功与订阅关联

后续步骤

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

使用计划创建订阅

将计划的 internalId 用作 planId 参数, 使用您的新计划创建客户订阅。

更新订阅计划

修改现有计划详情,同时保持与 有效订阅的关联。
最后修改于 2026年11月10日