跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://doc.haipay.net/llms.txt

Use this file to discover all available pages before exploring further.

这个页面用于帮助你快速理解 HaiPay 订阅业务的完整生命周期。建议先看流程摘要,再看分阶段图示,最后回到 订阅支付接口 和 API Reference 做具体接入。

创建订阅

用户授权订阅,完成首笔支付,并生成平台订阅号。

周期扣款

HaiPay 按周期自动扣款,并把结果异步通知给商户。

取消与结束

用户取消、超过最大周期或重试失败时,订阅结束。

流程摘要

1

用户发起订阅

商户调用订阅申请接口,HaiPay 返回授权地址或前端组件所需的支付令牌,用户完成授权与首笔支付。
2

订阅进入有效状态

首次支付成功后,平台生成 subscriptionNo,后续自动扣款都围绕这个订阅号进行。
3

平台按周期自动扣款

到达扣款周期后,HaiPay 自动发起扣款,并通过异步通知将结果同步给商户。
4

达到结束条件后终止

当用户主动取消、达到最大循环次数,或连续失败达到终止条件时,订阅结束。

关键状态理解

阶段你需要关注什么
创建订阅是否成功返回授权入口、用户是否完成首次授权与首笔支付
订阅成功是否拿到 subscriptionNo 并完成本地落库
周期扣款是否正确接收并处理每次异步扣款通知
取消订阅是否为用户提供清晰的退订入口,并同步取消结果
异常重试是否对失败扣款做好风控、通知和业务补偿策略
  • 首次支付成功后,立即保存 subscriptionNo、商户订阅号和用户标识之间的关系。
  • 不要只依赖前端结果页,订阅状态与扣款结果都应以服务端通知和查询接口为准。
  • 订阅业务务必向用户展示周期、金额、取消方式和服务协议。

创建订阅

目标:完成用户授权与首笔订阅支付,并建立订阅关系。 这一阶段的落地重点
  • 商户侧要保存商户订阅号与平台订阅号映射
  • 首笔支付结果不要只看前端页面,要结合通知或查询接口确认
  • 用户侧要清楚知道订阅金额、周期和取消方式

周期扣款

目标:在订阅有效期间,按约定周期自动续费。 这一阶段的落地重点
  • 服务端必须处理异步通知,并返回大写 SUCCESS
  • 建议在每次扣款前后都向用户发送站外提醒
  • 如果扣款失败,商户侧要定义好重试、降级或暂停服务策略
如果只依赖用户是否打开结果页,你会漏掉真实的周期扣款状态。订阅续费场景必须以服务端通知和查询接口做最终确认。

取消订阅

目标:在用户申请退订或业务终止时,及时停止后续扣款。 这一阶段的落地重点
  • 用户侧必须有清晰、可访问的取消入口
  • 取消成功后,要同步更新本地订阅状态
  • 如果取消前存在待处理扣款,需要在业务上明确最终权益边界

完整生命周期图

推荐阅读顺序

  1. 先看 订阅支付接口,确认你选择的前端集成模式。
  2. 再进入 订阅申请查询订阅 理解字段与返回结构。
  3. 最后确认 取消订阅 的业务处理方式,退款统一使用 信用卡退款接口

相关主题

Last modified on May 22, 2026