Documentation

卡密商品订单：自动发放与失败重试

卡密商品订单：自动发放与失败重试

适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。

用途与操作入口

卡密商品订单使用商城订单与订单项，管理员在订单中心的卡密商品订单视图处理，用户在我的订单及我的卡密查看结果。

开始前应创建卡密商品、准备可发放卡密，并核对商品的自动发放配置。

支付与发放

  1. 用户完成购买与支付。
  2. 按商品配置从可发放库存分配卡密。
  3. 发放成功后写入订单、订单项、用户和发放时间关联。
  4. 用户在我的卡密中查看交付资料。
  5. 库存不足或发放失败时，订单和订单项进入失败语义，并保留可查看的失败原因。

后台补录并指定为已支付的卡密订单，也应尝试发放；将待支付订单手动改为已支付时，遵循相同履约规则。人工指定支付状态不向支付渠道发起扣款。

失败重试步骤

  1. 进入卡密库，筛选目标商品，确认可发放数量。
  2. 库存不足时导入补货批次，并核对导入结果。
  3. 回到失败卡密订单，打开详情检查失败订单项与原因。
  4. 对符合条件的失败订单项执行重新发放。
  5. 读回订单项、卡密记录及用户侧我的卡密，确认关联正确。

编辑与管理限制

待支付时可调整商品与数量，金额随之重算；支付后商品和数量受到保护。不能向已有订单追加明细或单独删除订单项。仅待支付订单允许整笔删除，关闭规则与商品订单状态约束保持一致。

已成功发放的订单项不能重复发放。已发放卡密也不能按未发放库存停用或恢复；异常处理应保留原记录和关联。

常见问题

用户看不到卡密时检查是否登录购买账号、是否支付成功、自动发放是否开启、订单项是否失败，以及卡密的用户关联。发放失败后先核对结果，再决定补货和重试，避免把页面刷新当作重复交付操作。

相关文档

评论