简体中文
模拟联调通道:场景规则与运行开关
mock 的核心模型是「默认成功,例外靠覆盖」。搞清楚判定链的优先级,就不会出现「改了规则却不生效」。
判定优先级
对一笔交易按以下顺序判定,命中即停(高 → 低):
- 订单手动覆盖——收款确认页、订单列表、手机虚拟码上的单笔操作;
- 商户级覆盖——主体档案里给该商户配的场景覆盖;
- 服务商级覆盖——主体档案里给该服务商配的场景覆盖;
- 交易类型默认——下表写死的默认结果。
单笔操作永远赢;主体级覆盖赢在「批量改这一类交易的结果」,不需要逐单点。全局旁路(全部成功 / 全部失败)已在 0.3.0 下线:它和「默认成功 + 覆盖」模型正交,切了忘切会让整批交易静默失败。
各交易类型的默认结果
| 交易 | 无覆盖时的默认 | 要造其它结果 |
|---|---|---|
| 支付 | 即时成功 | 确认页点「支付失败 / 继续挂起」,或主体档案配支付覆盖 |
| 退款 · 支付宝 / 银联 / 抖音 / 聚合 | 即时成功 | 主体档案配退款覆盖 |
| 退款 · 微信 | 处理中 | 退款订单列表手动确认,或主体档案配退款覆盖 |
| 分账 | 按金额尾号规则,未命中处理中 | 分账规则表 |
| 预授权 | 冻结成功 | 建单后预授权页 fail,或主体档案配预授权覆盖 |
付款码没有「按金额尾号造失败」这种约定:要失败就用手机虚拟码模拟器的「立即失败」,挂起族直接由确认页人工点。
分账规则
分账规则是全站唯一保留的规则表,只有「金额个位」一个维度:同类型内按列表顺序先命中先赢,默认两条——尾号 1 成功、尾号 2 失败,未命中兜底处理中。
改规则即时生效,不影响已生成的单据。存量库里支付、退款、预授权的历史规则行会在启动时自动清理。
运行开关
| 开关 | 默认 | 说明 |
|---|---|---|
| 自动回调 | 开 | 所有终态自动发回调,失败按次数重试(退避 5s / 30s / 60s) |
| 扫码单推进 | 人工推进 | 可选「自动成功」,由调度器延迟 N 秒把挂起单推成功 |
| 回调重试次数 | 可配 0~10 | 自动回调失败的重试上限 |
| 微信 openid 校验 | 开 | JSAPI / 小程序支付按 appid、openid 拟真校验;关闭后整段跳过,仅用于调试对比 |
付款码的渠道前缀识别(微信 10~15、支付宝 25~30、银联 62 开头)是代码内写死的常量,不提供配置入口。要造「识别不出渠道」的场景,用一个不落在这些段里的码值(如 77 开头)。
常见造场景配方
| 场景 | 配法 |
|---|---|
| 支付成功 | 默认即可 |
| 支付失败 | 确认页点「支付失败」,或主体档案配支付覆盖 |
| 订单一直挂起(测超时/关单) | 确认页点「继续挂起」,不开自动推进 |
| 退款异步成功 | 微信退款:默认处理中 → 退款订单列表手动确认 |
| 退款失败 | 主体档案配退款覆盖 |
| 分账失败 | 金额尾号改成 2(或加一条尾号规则) |
| 分账处理中 | 金额尾号既不命中 1 也不命中 2 |
| 冻结失败 | 在管理台造预授权单后,预授权页操作 fail |
| 回调丢失 / 重推 | 关自动回调后补发,或把重试次数调到 0 再手动发 |