这个页面用于帮助你快速理解 HaiPay 订阅业务的完整生命周期。建议先看流程摘要,再看分阶段图示,最后回到 订阅支付接口 和 API Reference 做具体接入。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 按周期自动扣款,并把结果异步通知给商户。
取消与结束
用户取消、超过最大周期或重试失败时,订阅结束。
流程摘要
关键状态理解
| 阶段 | 你需要关注什么 |
|---|---|
| 创建订阅 | 是否成功返回授权入口、用户是否完成首次授权与首笔支付 |
| 订阅成功 | 是否拿到 subscriptionNo 并完成本地落库 |
| 周期扣款 | 是否正确接收并处理每次异步扣款通知 |
| 取消订阅 | 是否为用户提供清晰的退订入口,并同步取消结果 |
| 异常重试 | 是否对失败扣款做好风控、通知和业务补偿策略 |
创建订阅
目标:完成用户授权与首笔订阅支付,并建立订阅关系。 这一阶段的落地重点- 商户侧要保存商户订阅号与平台订阅号映射
- 首笔支付结果不要只看前端页面,要结合通知或查询接口确认
- 用户侧要清楚知道订阅金额、周期和取消方式
周期扣款
目标:在订阅有效期间,按约定周期自动续费。 这一阶段的落地重点- 服务端必须处理异步通知,并返回大写
SUCCESS - 建议在每次扣款前后都向用户发送站外提醒
- 如果扣款失败,商户侧要定义好重试、降级或暂停服务策略
取消订阅
目标:在用户申请退订或业务终止时,及时停止后续扣款。 这一阶段的落地重点- 用户侧必须有清晰、可访问的取消入口
- 取消成功后,要同步更新本地订阅状态
- 如果取消前存在待处理扣款,需要在业务上明确最终权益边界

