Documentation

卡密库：批次导入、库存与停用

卡密库：批次导入、库存与停用

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

准备与入口

进入控制台卡密库。卡密必须关联卡密商品，批次用于追踪一次导入，单条记录包含交付资料及发放关联。

状态含义
AVAILABLE可用于发放
DELIVERED已交付，保存订单与用户关联
DISABLED已停用，不进入可发放库存

导入步骤

  1. 选择目标卡密商品并填写批次名称。
  2. 粘贴数据，核对每行卡号与卡密：
CODE-001,SECRET-001
CODE-002----SECRET-002
CODE-003
  1. 查看预览，确认格式、商品和数量。
  2. 提交后读回批次与记录，核对实际导入数量和可发放状态。
  3. 如用于失败订单补货，再回订单详情重试对应失败订单项。

以上为格式示例，不能作为实际交付资料。

MCP 导入约束

MCP 导入需要稳定批次 ID，每次 1～50 行、总文本最多 10000 字符。可使用逗号、四连字符或单独卡号形式。批次 ID 重复提交会冲突，不能把重试当成新批次。

导入没有跨资源事务承诺。调用失败或超时后，先按批次 ID 查询批次和记录；若已部分保存，应核对已存在内容，不能盲目重放原请求。

停用与恢复

对尚未发放、未关联订单的卡密可执行停用或恢复。MCP 拒绝对已发放或已绑定订单记录执行这些动作。已发放记录保留发放时间、用户、订单及订单项，供交付追踪。

验收结果

批次计划数量、实际记录和状态计数能够对应，目标商品有足够可发放库存。MCP 查询只返回安全记录和状态，不返回卡号与卡密正文；用户获取资料应通过本人权益入口。

相关文档

评论