跳转到主要内容
Localpayment 提供了一个接口,用于检索现有订阅计划的详细信息。本指南将介绍如何通过 Localpayment 的 API 获取订阅计划详情,以便您验证计划配置、检查状态并在应用程序中使用计划信息。

开始之前

请确保您已备好:

API凭证

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

账户设置

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

IP白名单

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

Webhook endpoint

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

第一步:获取订阅计划详情

要检索订阅计划信息,请向获取订阅计划endpoint 发送 GET 请求。

关键请求参数

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

示例请求

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

步骤 2:处理响应

成功响应

请求成功后,将返回完整的订阅计划详情:

关键响应字段

错误响应

如果找不到或无法访问订阅计划,您将收到错误信息:

步骤 3:跟踪交易状态

获取订阅计划后,您可以确定其可用性和当前状态:

Webhooks(推荐)

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

状态 API endpoint

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

Business Portal 视图

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

常用状态码

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

测试您的集成

测试场景

请确认您的集成方案能够处理以下场景:
  1. 成功检索计划:获取现有有效计划的详细信息。
  2. 不存在的计划:尝试检索不存在的计划。
  3. 无效的计划 ID:请使用格式错误或不正确的 internalId 格式进行测试。
  4. 身份验证失败:检索具有无效或过期访问令牌的计划。

后续步骤

创建订阅计划

针对不同的服务级别或定价模式,制定新的订阅计划。

更新订阅计划

根据获取的信息修改现有计划细节。

使用计划创建订阅

使用计划 ID 创建新的客户订阅。
最后修改于 2026年11月10日