接入自动发卡前要确认哪些接口与数据

准备接入自动发卡时，很多人会优先纠结发卡方式，却忽略了订单创建与消息接收是否具备基础条件。无论是站内直接交付，还是外部电商接入，只要订单、商品、货源与通知链路里有一环没核对清楚，就会出现下单后无法发卡、卡密漏发或售后无法追溯的问题。下面按准备顺序说明需要确认的内容。

先确认接口权限与调用范围

自动发卡依赖商品、订单与售后相关接口，接入前先在接口文档中确认已开放的接口范围。账号管理类接口按需调用即可，商品分类、商品目录、商品详情、下单模板和订单创建属于基础调用项，订单详情查询应作为兜底能力保留。如果经营方式涉及自动采购，还需确认是否具备对应 API 权限，授权成功不等于自动采购权限自动开通。

普通卡密发货至少需要保证商品目录能查到在售商品、商品详情能取到规格、下单模板能生成表单、订单接口能创建并返回状态。只开通其中一个接口，后续订单流转就可能出现断点。

核对商品与规格的关联关系

自动发卡不能只看商品已上架，必须确认商品、规格和发货规则的对应关系。创建本地商品时先调用商品详情接口，确认返回的规格与计划销售的规格一致；多规格商品需要同时记录商品编号与规格编号，单规格商品不填规格编号时系统默认使用数字 0。

外部电商接入时，需要在电商管理中完成接入，再核对商品发布状态、关联的货源和发货规则。直充类商品必须关联站内货源，卡密类商品需要指定卡密仓库并配置发货规则，仅完成店铺授权而未配置货源，仍会出现无法自动发货的情况。

准备可核对的卡密仓库与库存

卡密发货需要有明确、可核对的卡密来源。准备阶段先确认卡密仓库的归属，以及库存是否可被查询和扣减。卡密导入后不要只看展示数量，应随机抽验卡密格式是否符合商品交付类型，并确认卡密字段完整，避免交付后出现卡密无效或核销失败。

使用假设示例：如果店铺计划销售会员月卡，卡密仓库中的卡密必须与该会员类型匹配，不能把其他商品的卡密混入同一发货规则。库存数量也需要能按商品、规格维度查看，否则自动发货时可能出现有库存却无法选中可发卡密的情况。

配置订单与卡密的回调地址

自动发卡涉及订单状态、卡密下发和售后消息，需要提前确认接收地址。Webhook 默认启用，不设置事件开关，在商户后台的接口管理中保存默认回调地址后，订单未单独填写回调地址时，会读取当时保存的默认地址。

单个订单也可以在创建订单时填写专属的订单回调地址，填写后该订单的订单变化、卡密、退款、关联售后和对应商品变化优先发送到该地址。确认地址时要保证地址为可访问的 HTTPS 公网地址，并提前规划收到消息后的处理方式，包括校验必填字段、保存事件编号、对同一事件编号去重，避免重复发卡或重复记录退款。

用一笔测试订单完成验收

准备完成后，用一笔明确的测试订单验收配置结果。测试订单提交商品、规格、数量等必填信息，不提交价格，由平台按下单时该账户的最新销售价格计算，实际扣款、订单金额与返回金额应一致。例如下单数量为 1，只核对金额是否一致，不要修改金额字段。

验收时查看返回的订单状态，按状态判断结果：pending 为等待处理，processing 为处理中，success 为已完成，canceled 为已取消，refunded 为已退款，partially_refunded 为部分退款。卡密商品在成功后应返回卡密列表，并确认回调地址收到卡密消息；若没有收到回调，优先使用订单详情接口查询当前结果，不要凭一次请求未收到就判定失败。

自动发卡的准备核心，不是堆叠功能，而是把订单能创建、商品能对应、卡密有来源、消息能接收这四项条件同时满足。顺序上先确认接口权限，再核对商品规格与货源，最后配置回调并用测试订单验证，才能真正跑通自动发卡。

参考资料：接入指南（2026-09-20）；店铺与电商接入疑问（2026-10-18）；创建订单（2026-08-31）。具体操作与适用范围以对应文档为准。