Skip to content

模拟联调通道:支付方式与模拟支付 ​

更新时间:2026/11/10 10:51:10

mock 按「渠道(provider)× 方式(way)」两个正交维度拟真。渠道是付款方用哪个钱包,方式是这笔单怎么被拉起。

九种方式 ​

way含义下单后状态payBody
QR扫码(Native)挂起确认页地址
SCAN扫码跳转挂起确认页地址
H5手机浏览器挂起确认页地址
PC电脑网站挂起确认页地址
APPAPP 拉起挂起确认页地址(模拟 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~1518 位
支付宝25~3016~24 位
银联6219 位
抖音无公开权威格式,跳过校验—

前缀识别是常量,不可配。要造「识别不出渠道」,用 77 开头这类不落段的码值。

手机虚拟码模拟器(/#/authcode)可以直接生成付款码二维码,支持 ?provider=WECHAT&mode=CONFIRM 预置,用来演示收银员被扫。

支付参数模拟 ​

这条路径解决「手上只有一笔下单产出的支付参数,怎么把支付做完」:

  1. 「模拟控制 → 支付参数模拟」粘贴微信或支付宝的 JSAPI / APP / 小程序支付参数;
  2. 点「解析并校验」:按字段级校验应用 appId、prepay_id、签名、时间窗,并识别场景与单号;
  3. 点「生成模拟二维码」得到短码与 /#/sim/{code} 链接;
  4. 手机扫码打开模拟支付页,点「模拟支付成功 / 模拟支付失败」完成裁决。
  • 命中 mock 订单:手机端操作同步推进订单终态并触发回调;PC 页每 3 秒轮询回显「手机已打开」「手机端操作结果」与最近一条回调送达(HTTP 状态 + 应答体);
  • 未命中订单:只记录模拟结果,页面橙色提示「不会触发支付回调」,PC 页降级为「未命中 mock 订单 · 仅参数验证」。

支付宝 JSAPI 的 payBody 是纯交易号串,直接粘贴即可解析;微信 JSAPI / 小程序是 prepay JSON(package 里带 prepay_id=mock_...)。

微信拟真 ​

页面地址用途
拟真微信授权/#/wxauth模拟公众号网页授权的跳转与回调
拟真微信支付/#/wxpay/{tradeNo}模拟微信内支付页的确认动作

配合「微信 openid 校验」开关,可以演练 appid / openid 不匹配的失败路径;关掉开关则整段跳过,仅用于对比调试。