小红书推出虚拟卡券专属履约链路，打通发券、核销与售后

1、业务场景 小红书电商平台正式推出虚拟卡券品类专属履约链路，支持商家在平台上售卖卡券类商品（如餐饮券、充值卡、会员卡等），并支持通过开放接口完成发品、发券、核销及售后的全链路闭环 该业务模式适合有卡券体系能力的商家入驻，支持用户在小红书APP下单后，商家系统制券生成对应的券码（包括卡密和卡链）并同步至小红书平台，对于支持回传核销状态的券码，用户凭到商家处核销并享受服务。 适用类目：兑换券一级类目、虚拟充值 > 游戏充值 > 主机/买断制游戏三级类目、虚拟充值 > 生活娱乐充值 > APP STORE充值三级类目 上线时间：新卡券履约链路在2026-08-21上线，平台将在2026-08-31开始不再支持相关类目原商品的订单履约方式，相关类目经营商家需要尽快切换到新履约链路，避免影响商家经营 2、业务流程

3、本次API变动说明 领域API/消息变更类型变更说明 商品域公共 API： common.getCategories 查询类目新增出参字段新增 virtualCategoryTypes（含 4=卡券直充、5=卡密兑换，作为卡券接入开关） 新增 supportAfterSaleList 售后能力规则：freeReturn 七天无理由、refundableIfUnredeemed 未核销随时退、autoRefundAfterExpiry 超期自动退（含 autoRefundAfterExpiryTimeRule，timeType 4 相对/5 绝对，min、max 单位小时） 公共 API： common.getDeliveryRule 获取发货规则调整出参字段supportFulfillmentWays[].fulfillmentWay 新增 DELIVERY_THEN_REDEEM（发货后核销）、DELIVERY_ONLY（仅发货） 商品 API： product.createItemAndSku / product.updateItemAndSku 创建/更新商品新增入参字段新增 virtualItemType（4/5）、fulfillmentType（DELIVERY_THEN_REDEEM/DELIVERY_ONLY）、instructionImages（卡券必填，使用说明图，元素结构为 List<Material>）、instructionJumpLink（使用说明跳转链接）、refundableIfUnredeemed（0/1）、autoRefundAfterExpiry（enable/type/time，仅发货后核销） 商品 API： product.getDetailSkuList / product.getItemInfo / product.searchItemList 商品查询新增出参字段出参回读上述发品字段（virtualItemType、fulfillmentType、instructionImages、instructionJumpLink、refundableIfUnredeemed、autoRefundAfterExpiry） 履约域订单 API： order.getOrderDetail / order.getOrderList 订单详情/列表调整出参字段订单orderTagList 新增 VIRTUAL_COUPON 标，标识新卡券订单 订单 API： order.couponDelivery 发券新增接口商家发券(发货)，回传发券结果 SUCCESS/FAILURE（FAILURE 仅直充账号错误，触发发券失败自动退），平台落库券码并推进订单已发货 订单 API： order.couponVerify 核销回传新增接口商家回传核销结果，仅 verifyType=1（有核销）订单支持回传核销，平台落库核销流水并推进订单已完结 订单 API： order.couponList 查券新增接口商家查询订单券码状态和明细 履约消息： msg_fulfillment_coupon_status_change 卡券状态变更新增消息发券成功 / 核销回传 / 超期自动退 / 随时退售后完成时推送卡券变更消息 履约消息： msg_fulfillment_soon_cancel 履约单即将取消通知新增消息字段新增 orderType（1 虚拟充值、2 虚拟卡券）与 cancelType（1 发货超期即将自动退、2 核销超期即将自动退） 平台在卡券超期前 6 小时，会向商家推送即将超期预警消息。商家收到后，可及时检查卡券核销状态并做补偿核销操作，尽量避免自动退款带来的核销资损。 售后域售后消息：msg_after_sale_create消息/接口不变卡券未核销随时退：商家自主审核（校验券码未核销）回传 agree/reject，超时（48h）平台自动同意 未核销超期退：平台自动同意 ，无需回传结果 售后 API： afterSale.getAfterSaleInfo / afterSale.auditReturns 4、Q&A Q1：虚拟卡券商品必须使用发券接口发货？ A1：商品发布时若选择卡券履约方式（发货后核销/仅发货）发品，生成的新卡券订单必须使用开放平台新增的 order.couponDelivery 接口回告发券结果，原有发货方式一律禁用；使用原发货模式的存量卡券商品生成的老订单，其发货方式不受影响。新卡券订单可通过 order.getOrderDetail 返参 orderTagList 含 VIRTUAL_COUPON 标识别新卡券订单 Q2：如何正确使用卡券核销接口？ A2：支持回传核销结果的卡券订单（verifyType=1），商家在调用超时或异常时建议多次重试（idempotentId 保持不变保证幂等），日常建议使用 order.couponList 查询对账，保证平台与商家卡券状态一致，降低商家资损风险 Q3：新卡券订单何时自动确认收货 / 自动取消？ A3：无核销券（verifyType=2）发券成功后发货 +7 天自动确认收货；有核销券（verifyType=1）发券后停留已发货待核销，核销回传完成即确认收货，未核销超期则平台自动发起超期退并退款