Skip to content

模拟联调通道:交易与人工裁决 ​

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

mock 服务对每笔交易只做两件事:按判定链给出结果,然后按开关决定要不要发回调。人工裁决是它区别于普通假接口的地方——你可以让同一笔单停在「挂起」,再决定成功还是失败。

五类单据 ​

单据是否即时终态推进方式
支付订单付款码即时;扫码/H5/PC/APP/公众号/JSAPI/小程序挂起收款确认页人工裁决,或自动推进开关
退款订单支付宝/银联/抖音/聚合即时成功;微信默认处理中退款订单列表手动确认,或主体覆盖
分账单按金额尾号规则,未命中处理中联调配置里的分账规则表(唯一规则表)
转账订单即时管理台内建单,创建即出结果
预授权冻结成功,后续请款/解冻预授权页操作,或主体覆盖

支付 ​

挂起族下单只存单不判终态,返回的 payBody 就是收款确认页地址。页面上三个按钮:

  • 确认支付成功:推成功终态并触发回调,回显回调送达的 HTTP 状态与应答体;
  • 支付失败:推失败终态,同样触发回调;
  • 继续挂起:什么都不做,留给你观察超时、关单等场景。

付款码(BARCODE)走场景引擎即时判定,没有确认页。要造付款码失败,用手机虚拟码模拟器的「立即失败」模式。

聚合支付(一码多付) ​

下单渠道为 provider=AGGREGATE(平台方式 aggregate_pay_qrcode)时按 QR 挂起,确认页展示微信、支付宝、云闪付、抖音四个钱包按钮,点哪个钱包就是哪个钱包付款成功,订单会记下实际钱包。

实际钱包通过两条回执回传主应用:同步回执的 provider 字段,以及回调报文 data.provider(仅聚合单且已选钱包时携带)。主应用据此把订单与资金凭证的渠道从聚合回填成实际钱包。

聚合单推成功但没带钱包,会被按错误码 40404 拒绝——聚合的成功必须能说清是哪个钱包付的;失败与挂起不要求。

退款 ​

退款按渠道区分默认结果:支付宝、银联、抖音、聚合即时成功;微信默认处理中,用来演练「发起 → 异步回调 → 单据翻转」的完整链路。

要改某个主体的退款结果,在主体档案配退款覆盖;临时改一笔用退款订单列表的手动确认。

分账 ​

分账是纯查询式交易,既没有落地页也没有回调能让它翻转,规则是唯一的自动判定手段,所以它是全站唯一保留的规则表。金额只按个位一个维度判定,同类型内按列表顺序先命中先赢,默认两条:尾号 1 成功、尾号 2 失败,未命中兜底处理中。详见场景规则与运行开关。

转账与预授权 ​

转账只在管理台内建单与查询,网关没有对应端点,主应用不会调用它。预授权的默认结果是冻结成功。网关的冻结契约里不带通道商户号,因此走网关的冻结请求一律按默认成功,无法用主体覆盖改结果;要演练冻结失败,请在管理台造单或直接在预授权页操作。

回调 ​

开关行为
自动回调开启后所有支付/退款终态自动发回调,失败按次数重试
回调重试次数上限 0~10,退避间隔 5s / 30s / 60s
微信 openid 校验JSAPI/小程序支付的 appid/openid 拟真校验,关闭后整段跳过

每条回调都留痕:发送时间、HTTP 状态、应答体。回调没到时先看订单详情里的回调记录,再查主应用的后端访问地址是否可达,见常见问题与排障。

人工补发

自动回调关闭、或重试次数用尽后,可以在订单列表与预授权页对单条交易手动补发,用于验证主应用的幂等与验签。