自动发卡平台接货源，验收卡密同步链路

接入自动发卡平台时，不少人以为卡密导入成功就等于发货链路完整，实际缺的往往是同步链路的验收。导入完成只代表库存落库，并不等于订单能稳定拿到卡密，后续自动发卡、退款和售后都会受到影响。下面只解决一个问题：如何逐项验收卡密同步链路，确保订单能按预期拿到卡密。

判断同步链路是否完整，先看哪三项

验收链路前，先明确三项核心判断依据。第一，卡密来源与发货类型一致，卡密、卡号加卡密、固定卡密与充值货源用途不同，不能用同一库存覆盖全部商品；第二，商品或规格已经绑定到正确货源，并处于启用状态，否则导入的卡密不会进入可售范围；第三，Webhook 回调地址配置正确，卡密消息能被接收、保存并进入后续流程。三项只要有一项缺失，就可能出现有单无卡或卡密延迟的情况。

第一步：核对卡密导入结果与可售数量

先在货源侧查看导入后的卡密格式是否与当前商品匹配，再核对有效可售数量是否同步到商品库存。例如导入的是卡号加卡密，商品却设置为单卡密发货，即便总库存增加，也不能直接认为绑定完成。此时还要检查卡密状态，确认未被标记为已售或失效，避免可用数量低于页面展示值。

核对标准是：商品详情页显示的可售数量与货源侧的可用数量一致；导入卡密与商品发货类型相同，且没有出现只增加总库存、没有绑定到商品或规格的情况。若数量不一致，先核对导入记录与商品绑定关系，再重新同步一次，不直接认为平台延迟。

第二步：确认货源绑定与选源策略

卡密导入完成后，还要回到商品配置查看货源绑定是否正确。进入商品管理页面，确认当前商品绑定的是对应货源，且该货源处于启用状态。多货源场景下，还要核对选源策略，低价优先、自营优先和顺序轮询的分配规则不同，不能以货源列表的排序推断每一单必走某渠道。

验证动作是手动创建一笔测试订单，确认订单命中的货源与预期一致，再查看该订单是否能拿到卡密。若货源未启用或绑定错误，订单会停留在等待卡密状态；此时先修正绑定关系，不通过重复导入来掩盖问题。选源策略变化时，还要同步查看对应商品的绑定是否仍有效。

第三步：验证订阅与商品变化通知

订单创建成功后，平台会自动创建或续期对应商品订阅，后续商品变化可正常接收。若需要在第一笔订单前接收商品变化，可调用接口订阅商品；不订阅也能查询模板和创建订单，但变化通知的及时性会受影响。验收时查看商品订阅状态是否为已订阅，并核对当前回调地址是否正确。

订单填写了专属回调地址时，订单、卡密、退款、商品变化及关联售后消息优先发送到该地址，且订单创建后不能更换；未填写时，每条消息生成时读取当时的默认回调地址。验证动作是触发一次商品状态变化，确认接收到的消息来源与地址一致，并记录 eventId，以便后续去重。

第四步：按回调消息确认自动发卡

收到卡密消息后，先检查 JSON 格式与必填字段是否完整，再保存 eventId 用于幂等校验。同一个 eventId 再次收到时，不要重复发卡或追加售后消息。卡密消息必须先安全保存，再交给后续发货流程，不能先调用发货接口再补存数据，否则重复消息容易造成卡密错发。

验收标准是：同一张卡密不会因重复消息被多次发出；卡密在消息到达后进入可查询状态，订单状态能同步为已完成；出现退款或撤单时，对应卡密不会被再次使用。若消息未到达，优先用订单详情查询状态、卡密和退款结果，不直接重发订单。

常见异常与修正方向

若订单已扣款但没有卡密，先按原订单号查询订单详情，确认 orderState 和卡密字段，再回到货源侧查看可用库存。库存为零时，先补入有效卡密并确认商品绑定，不直接创建新订单；补货后仍无卡密，再检查选源策略是否把订单分配到了未绑定货源。

若卡密已出但订单状态异常，先核对回调地址是否被修改、消息是否生成。消息生成时既没有订单地址也没有默认地址，该条 Webhook 不会发送，订单仍正常创建，需要用查询接口获取结果，不能用重复下单来验证。

这套验收方式适用于外部货源导入、平台托管卡密及订单回调发卡的场景；如果你的货源是本地直发或人工处理，则不需要验收同步链路，改为核对人工发卡记录和订单状态即可。

参考资料：接入指南（2026-09-20）；创建订单（2026-08-31）；库存与发货异常（2026-10-18）。具体操作与适用范围以对应文档为准。