简体中文
模拟联调通道:交易与人工裁决
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 状态、应答体。回调没到时先看订单详情里的回调记录,再查主应用的后端访问地址是否可达,见常见问题与排障。
人工补发
自动回调关闭、或重试次数用尽后,可以在订单列表与预授权页对单条交易手动补发,用于验证主应用的幂等与验签。