简体中文
模拟联调通道:支付方式与模拟支付
mock 按「渠道(provider)× 方式(way)」两个正交维度拟真。渠道是付款方用哪个钱包,方式是这笔单怎么被拉起。
九种方式
| way | 含义 | 下单后状态 | payBody |
|---|---|---|---|
| QR | 扫码(Native) | 挂起 | 确认页地址 |
| SCAN | 扫码跳转 | 挂起 | 确认页地址 |
| H5 | 手机浏览器 | 挂起 | 确认页地址 |
| PC | 电脑网站 | 挂起 | 确认页地址 |
| APP | APP 拉起 | 挂起 | 确认页地址(模拟 APP 内收银界面) |
| MP | 公众号 | 挂起 | prepay JSON |
| JSAPI | 网页 / 小程序内 | 挂起 | prepay JSON |
| MINI_APP | 小程序 | 挂起 | prepay JSON |
| BARCODE | 付款码被扫 | 即时 | 无 |
挂起族下单只存单、不判终态,终态由确认页人工推进,或按「扫码单推进」开关延迟自动成功;付款码由场景引擎即时判定。
主应用侧把平台支付方式折算成 way(仅无固定渠道的 OTHER 不在模拟范围),对应关系见 MockPayService.mapWay 注释。
聚合支付(一码多付)
下单渠道是 provider=AGGREGATE(平台方式 aggregate_pay_qrcode)时,按 QR 挂起并返回确认页地址,也就是那张「一码多付」的码。
确认页把「确认支付」换成四个钱包按钮:微信、支付宝、云闪付、抖音,点哪个就是哪个钱包付款成功。订单记下实际钱包,并通过同步回执与回调报文把实际钱包回传主应用。
聚合单推成功但不带钱包,会被 40404 拒绝;失败与挂起不要求钱包。
付款码
付款码按渠道校验基础格式,不合法返回内部码 10022:
| 渠道 | 前缀 | 长度 |
|---|---|---|
| 微信 | 10~15 | 18 位 |
| 支付宝 | 25~30 | 16~24 位 |
| 银联 | 62 | 19 位 |
| 抖音 | 无公开权威格式,跳过校验 | — |
前缀识别是常量,不可配。要造「识别不出渠道」,用 77 开头这类不落段的码值。
手机虚拟码模拟器(/#/authcode)可以直接生成付款码二维码,支持 ?provider=WECHAT&mode=CONFIRM 预置,用来演示收银员被扫。
支付参数模拟
这条路径解决「手上只有一笔下单产出的支付参数,怎么把支付做完」:
- 「模拟控制 → 支付参数模拟」粘贴微信或支付宝的 JSAPI / APP / 小程序支付参数;
- 点「解析并校验」:按字段级校验应用 appId、prepay_id、签名、时间窗,并识别场景与单号;
- 点「生成模拟二维码」得到短码与
/#/sim/{code}链接; - 手机扫码打开模拟支付页,点「模拟支付成功 / 模拟支付失败」完成裁决。
- 命中 mock 订单:手机端操作同步推进订单终态并触发回调;PC 页每 3 秒轮询回显「手机已打开」「手机端操作结果」与最近一条回调送达(HTTP 状态 + 应答体);
- 未命中订单:只记录模拟结果,页面橙色提示「不会触发支付回调」,PC 页降级为「未命中 mock 订单 · 仅参数验证」。
支付宝 JSAPI 的 payBody 是纯交易号串,直接粘贴即可解析;微信 JSAPI / 小程序是 prepay JSON(package 里带 prepay_id=mock_...)。
微信拟真
| 页面 | 地址 | 用途 |
|---|---|---|
| 拟真微信授权 | /#/wxauth | 模拟公众号网页授权的跳转与回调 |
| 拟真微信支付 | /#/wxpay/{tradeNo} | 模拟微信内支付页的确认动作 |
配合「微信 openid 校验」开关,可以演练 appid / openid 不匹配的失败路径;关掉开关则整段跳过,仅用于对比调试。