咖啡兑换券下单后卡密验收要按什么顺序核对
咖啡兑换券购买后不能只看卡密是否到手，还要按交付类型、券面规则和订单结果逐一验收。本文给出可执行的核对顺序，帮你在核销前自行判定权益是否有效。
购买咖啡兑换券后，许多人把拿到卡密等同于交易完成，直到顾客到店核销失败才发现权益状态异常。验收的核心不是核对数量，而是按固定顺序确认交付类型、券面规则与订单结果，下面把每一步的判断标准和核对动作拆开。
第一项是先确认交付类型，排除非卡密商品。调用商品详情接口后，检查deliveryKind字段的返回值，仅当该字段为card时，才属于需要交付卡密的兑换券商品；返回值为recharge时，表示该商品是充值类权益，后续应通过充值流程处理，不能按卡密核销路径验收。这一步直接决定了后续验收方式，若交付类型与实际需求不一致，卡密不会正常生成，后续核对都会失去基准。
第二项是逐条核对券面规则，覆盖实际核销场景。调用商品详情接口获取notices字段，该字段内容为富文本HTML，没有注意事项时返回空字符串。验收时需逐条查看其中的规则说明，重点核对核销范围、有效期、适用门店与特殊限制，确认券面规则与实际消费场景匹配。例如，假设顾客购买的是指定门店使用的咖啡兑换券，若notices中明确限定仅部分门店可用，就需要先确认目标门店在范围内，再进入下一步验收。
按状态判断卡密与规格是否可售
卡密交付完成后，需确认对应规格的可售状态，排除库存与状态异常导致的权益不可用。调用商品详情接口后，先检查availability字段，仅当返回值为available时，商品整体处于可售状态；返回值为unavailable时，商品暂时不能购买，此时即便已拿到卡密，也要暂停验收并联系供应方确认状态。
若商品存在多规格，还需逐一检查variants数组中对应规格的availability字段，仅当对应规格返回available时，该规格的权益才是可核销状态。同时查看inventoryType字段，当该字段为tracked时，remainingUnits字段返回可售数量，验收时可据此确认库存是否充足，避免因库存耗尽导致权益无法使用。
核对订单与交付结果
卡密与状态核对通过后，需对订单结果做一次验收。先检查接口返回的code字段，仅当返回值为0时，表示本次请求成功；返回其他值时，说明订单或查询过程存在异常，需保留本次请求的requestId用于后续排查。核对卡密时，要对照券面规则中记载的数量与有效期，确认卡密数量与购买规格一致，不存在缺漏或错误。
验收过程中若发现卡密异常或状态不符，需第一时间留存商品详情接口返回的完整结果，包括productRef、对应variantRef、availability字段值及requestId，不要在未核实状态时重复下单或更换账号核对，避免产生重复交易。
整个验收过程的取舍关键在于两点：一是交付类型必须与卡密核销需求匹配，二是券面规则必须覆盖实际使用场景。只有这两项同时满足，后续核对才有意义，这也是判断一次咖啡兑换券购买是否合格的最低标准。
验收时还要留意商品最后更新时间，调用接口后查看revision字段，该字段是10位Unix秒级时间戳，记录商品最后更新时间。若时间戳更新时间晚于下单时间，说明商品规则在下单后发生过变动，需再次对照最新notices内容确认规则，避免因规则调整导致卡密实际权益与购买时不一致。
规格下单模板版本同样需要关注，查看对应variants项的purchaseSchemaRevision字段，若该值发生变化，需重新获取当前规格的下单模板，确认订单内容与最新模板一致。这一步能排除因模板版本差异导致的权益信息错配，确保验收结果与实际可核销权益完全对应。
参考资料：查询商品详情（2026-08-22）。具体操作与适用范围以对应文档为准。