开始之前
请确保您已备好:API凭证
用于身份验证的有效 API 凭据和访问令牌。
账户设置
为您的目标国家/地区正确设置账户并进行业务验证。
IP白名单
将服务器 IP 地址加入 API 访问白名单。
Webhook endpoint
设置 webhook URL 以接收付款通知。
第一步:获取订阅计划详情
要检索订阅计划信息,请向获取订阅计划endpoint 发送GET 请求。
关键请求参数
该请求需要几个关键参数:示例请求
以下是使用curl 的示例:
curl
步骤 2:处理响应
成功响应
请求成功后,将返回完整的订阅计划详情:关键响应字段
错误响应
如果找不到或无法访问订阅计划,您将收到错误信息:步骤 3:跟踪交易状态
获取订阅计划后,您可以确定其可用性和当前状态:Webhooks(推荐)
交易状态变更时接收实时通知。最适用于生产环境。
状态 API endpoint
以编程方式查询事务状态。可用于轮询或恢复丢失的 webhook 通知。
Business Portal 视图
用于监控交易的可视化界面。非常适合人工监督和详细的交易分析。
常用状态码
完整参考请查看我们的交易状态文档,了解所有状态代码。
测试您的集成
测试场景
请确认您的集成方案能够处理以下场景:- 成功检索计划:获取现有有效计划的详细信息。
- 不存在的计划:尝试检索不存在的计划。
- 无效的计划 ID:请使用格式错误或不正确的 internalId 格式进行测试。
- 身份验证失败:检索具有无效或过期访问令牌的计划。
后续步骤
创建订阅计划
针对不同的服务级别或定价模式,制定新的订阅计划。
更新订阅计划
根据获取的信息修改现有计划细节。
使用计划创建订阅
使用计划 ID 创建新的客户订阅。

