小程序虚拟支付集成要点与发布前核查清单

为保障虚拟支付业务稳定上线并避免线上资损，请在发布前对照以下核心规范与清单进行逐项核验。

一、业务约定规范

• 商户单号规则：outTradeNo 必须全局唯一，推荐格式：T + 时间戳 + 随机数（长度建议 8~32 位，不可以下划线开头）。
• 禁止复用单号：每次拉起下单都必须生成全新单号，严禁复用历史单号。
• 金额单位：前后端全链路金额统一使用「分」，严禁随意换算为元导致精度丢失。
• 环境参数：正式线上环境 env 固定填 0；沙箱联调测试填 1。

二、安全与稳定性保障

• 双重签名校验：严格按照官方规则在服务端实现 paySig 和 signature 计算。
• 发货依据：坚持以服务端推送作为发货准则，前端回调仅作 UI 引导，切勿作为发货凭据。
• 幂等去重：严格依据 wx_order_id 实现防重复发货校验。
• 查单补偿：配置定时扫描轮询任务，建议每 5 分钟调用 query_order 对未发货订单进行对账补发。

三、多终端适配要求

• iOS 版本校验：拉起支付前检查微信客户端是否达到 8.0.68 及以上。
• Windows/PC 兼容：电脑端微信也支持 wx.requestVirtualPayment，逻辑中切勿硬编码仅判断 Android。
• Apple 支付环境：Apple IAP 支付不支持沙箱联调，必须在现网环境下使用真实小额测试。

四、上线前必备检查清单 (Checklist)