先选择交付方式
打开商品编辑页,先将商品设为虚拟商品,再配置「数字交付」。请使用有权编辑该商品的后台账号操作。
数字交付有三种方式:付款后显示说明文字、提供文件下载,或通过已接入的服务发放卡密等内容。上传一个公共附件,不会自动变成“一人一卡”。
| 交付方式 | 需要填写什么 | 使用前确认 |
|---|---|---|
| 文本 | 填写买家付款后看到的说明。 | 可以使用允许的 HTML 排版;保存时会过滤不安全的内容。 |
| 文件下载 | 选择媒体库附件,填写展示名称、下载说明、次数和有效天数。 | 必须选中本站有效附件。只填文件名或自行填写下载地址,不能代替附件。 |
| 接口履约 | 填写服务标识、外部商品编码、子类型和说明。 | 对应服务必须已经接入,并具备可用库存或交付能力。仅填写标识不会自动接通第三方服务。 |
配置文件下载限制
- 在媒体库中选择要交付的文件,填写便于买家识别的展示名称。
- 需要限制下载次数时,启用限制并填写明确的正整数。
- 填写有效天数,保存商品。
- 创建一笔测试订单并完成付款,在订单详情中打开文件链接,核对文件、期限和次数。
有效天数填 0 不代表永久。当前签名下载链接会采用默认 7 天;扩展可以修改默认值,最终期限限制在 1~365 天。
启用次数限制后,如果最大下载次数不是正数,订单策略会按 1 次处理。次数按订单行中的每个文件分别记录,与文章的每日下载额度分开计算。
需要独立卡密时,先准备数字资产池
进入数字资产池管理页面,先生成或导入库存,再回到商品的接口交付设置中关联。管理资产池需要相应后台权限。
| 设置 | 填写方法与限制 |
|---|---|
| 批次代号 pool_key | 用于区分用途或面额。商品的「外部商品编码」必须与它一致。 |
| 卡种 kind | prepaid_code 表示一段码或充值码,gift_card 表示卡号加 PIN,license 表示授权码。商品与库存的卡种必须完全一致。 |
| 充值卡生成 | 填写批次、数量、适用货币的入账金额和备注。生成前先配置结账货币。 |
| 卡密格式 | 按需要设置前缀、随机段长度和字符集;易读字符组合适合需要手动输入的卡密。 |
| CSV 导入 | 使用 UTF-8 编码,第一行为表头,包含 pool_key、kind 和对应的卡数据列。按页面列说明整理文件后再导入。 |
| 库存状态 | 付款后从匹配批次和卡种的「待售」库存中,按编号从小到大取卡。仓库总数不等于可发放数量。 |
在仓库中按批次和状态筛选记录,核对待售、已售、已使用或已作废状态;需要追查交付时,再检查卡记录关联的订单。补货可继续使用相同批次代号和卡种。
单独赠送或只用于余额充值的卡,建议放在独立批次,避免被售卖商品取走。余额兑换还需要卡具备对应的充值用途和金额配置;不能把所有授权码都当作充值卡。
测试充值时,从适用的财富入口输入卡号或卡密;礼品卡按要求填写 PIN。核对入账货币、金额及使用状态。已使用或已作废的卡不能再次正常核销。
检查规格与历史订单
同一商品的不同规格组合称为「变体」。如果各规格交付不同文件或卡密,分别检查它们的交付配置,不要只检查主商品。
未配置变体交付与明确保存为空配置,不一定有相同的回退结果。每个要出售的规格都应完成一次下单验证。
订单会保留下单时的交付快照。修改当前商品,不代表旧订单中的交付内容会一起更新;排查旧单时,应查看订单内保存的内容。
复制或翻译商品后,重新核对交付文字、附件和外部编码。翻译说明文字不会生成新卡密,也不会生成另一种语言的文件。
交付失败时检查什么
- 文件没有出现:检查是否选中了有效附件,以及测试订单是否已确认付款。
- 文件无法下载:检查链接期限、下载次数、附件是否仍存在,以及订单是否允许下载。
- 库存有卡却发不出:检查服务是否接入,批次代号、卡种和「待售」状态是否匹配。
- 交付内容还是旧的:先核对订单快照,再判断是否需要处理该笔订单。