Documentation
套餐履约:父子订单、权益与异常恢复
套餐履约:父子订单、权益与异常恢复
适用版本:产品管理插件 3.1.0;内容依据当前源码核对,更新日期:2026-10-10。
两段履约
套餐父订单支付成功后,产品插件依据下单时的成员快照创建成员订单。Core 随后依据权益计划,按快照顺序完成成员授权、安装或更新、启动和验证。
父订单承担金额与支付事实,成员订单为零元成功记录。父 Key 本身没有安装包,不能作为插件或主题安装。
权益履约状态
| 状态 | 含义 |
|---|---|
WAITING_PAYMENT | 等待父订单支付成功 |
PROVISIONING | 正在准备成员权益 |
READY | 成员权益已就绪 |
PARTIAL_FAILED | 部分成员失败,需要检查或恢复 |
系统保存逐成员检查点。成员失败不会回滚已经成功的成员,也不会取消父订单支付事实。进程恢复后可按检查点继续,但必须核对成员订单的父订单、用户、产品、期限及来源一致性。
异常处理步骤
- 查找父订单,确认支付状态与付款账号。
- 核对下单时的套餐成员快照,勿以当前套餐配置替换历史成员。
- 查看成员权益错误码及可重试标志。
- 临时保存或创建故障,在恢复环境后通过支持的权益计划流程继续。
- 父子订单、用户或期限冲突需要先人工核对数据;不可重试冲突不能靠不断重试解决。
- 权益已就绪但安装失败时,转到 Core 的套餐安装任务核对实际应用状态,并继续失败或未完成成员。
安装恢复
Core 承担服务端安装编排,浏览器负责发起和查看任务。关闭页面不等同于取消安装。后续成员失败时保留成功成员,继续安装只处理需要恢复的成员,不自动卸载成功应用。
兼容条件与限制
Core 需声明 bundle-v1 或 bundle-v2 能力才能看到并购买套餐;bundle-v2 增加稳定错误码和可重试信息。当前方案不提供退款撤权、自动卸载、成功成员回滚、实物或卡密成员以及嵌套套餐。
验收结果
核对父订单、全部成员权益及 Core 中实际安装状态。支付成功、权益就绪、安装完成应分别确认;其中一项成功不能替代另外两项。
评论