卡易速自动发卡货源对接的确认与验证步骤

对接卡易速自动发卡货源时，不少经营者只确认品类和单价，忽略了货源类型与发货链路的匹配要求，等到首笔订单卡密未正常发出，才回头排查，不仅拉高售后成本，还容易把货源问题误判为店铺配置问题。要判断货源是否可直接用于自动发卡，需要从货源性质到履约规则逐层核对。

先核对货源类型与经营目的是否匹配

卡易速支持的货源包含卡密、卡号加卡密、固定卡密与充值四类，四类货源的实际用途和交付方式并不相同。卡密类货源的核心交付物是单组可用于核销的卡密，适合用户自助查询提取；充值类货源依赖系统间的额度调用与状态回传，适合直充场景。

核对时，先看货源详情页标注的类型，再对应自身的售卖方式。做自动发卡售卖卡密，优先核对卡密类货源；若选用充值货源做卡密自动发货，很可能因为交付链路不一致，出现卡密生成失败。这一步确认清楚，能避免从货源源头就选错方向。

核对货源的上架状态与订阅有效期

货源不能只处于“可查询”状态就判定为可用。在卡易速货源列表中，需要确认货源处于已上架、可售状态，且订阅未到期。若使用接口对接，调用 GET /goods/catalog 查询商品列表时，需核对列表返回的订阅状态和到期时间，仅当订阅有效时，后续自动采购或卡密同步才能正常执行。

需要补充的是，即使未提前订阅商品，也可查询下单模板并创建订单，但无法主动接收商品变化通知。若希望第一笔订单前就感知货源库存或价格调整，应调用 POST /goods/subscriptions 完成订阅，通过 product.changed 事件获取变化信息。

核对货源库存的有效可售数量与格式

卡密类货源的库存不能只看总数量，必须确认有效可售数量。导入卡密后不发卡的常见原因之一，就是导入格式不符合要求，或者有效可售数量为零，仅总库存有值。此时即使货源显示有库存，也无法完成自动发卡。

核对时，先在货源详情页查看库存明细，区分已售、锁定、不可售数量，再核对导入文件的格式与平台要求是否一致。多货源场景下，还要确认当前生效的选源策略，低价优先、自营优先和顺序轮询的分配规则不同，不能用货源列表的排序推断每一单必定走某一渠道，应结合策略说明确认实际履约路径。

核对发货规则与商品规格的绑定关系

货源选对后，若发货规则配置不当，依然无法稳定交付。自动发卡场景下，卡密商品需配置卡密仓库和对应发货规则，直充商品需关联本站充值货源。自动采购还需单独开通API权限，仅完成店铺授权不足以支撑自动发货。

核对时，先进入商品管理页面，确认目标商品已绑定正确规格，再检查发货规则的触发条件与卡密发放逻辑。例如，用户下单后系统是否按规则自动提取有效卡密、发放失败是否有明确日志、是否支持按订单号回查发放记录。这些细节直接决定自动发卡的稳定性。

用异常场景验证货源与系统的联动

货源对接的最终判断，需要通过异常场景验证。遇到发货失败时，先查看原订单日志及渠道返回结果，确认是明确失败还是结果不确定。仅当确认订单已撤销且未交付时，再使用允许的补单流程，结果不确定时先人工核查，避免卡密重复发放或充值重复到账。

若通过接口对接，还需验证Webhook处理逻辑。卡密消息必须先安全保存，再进入后续发货流程；收到 order.changed 事件时，需结合 GET /orders/{clientOrderRef} 查询订单详情，确认订单当前状态，避免仅凭一次通知判断发货结果。

完成以上核对后，货源若同时满足类型匹配、订阅有效、有效可售库存充足、发货规则配置正确，且异常处理有明确日志支撑，即可判定为可直接用于自动发卡的货源，后续只需定期核对订阅状态与库存即可。

参考资料：接入指南（2026-09-20）；库存与发货异常（2026-10-18）；店铺与电商接入疑问（2026-10-18）；电商店铺与选品（2026-10-18）。具体操作与适用范围以对应文档为准。