简体中文
模拟联调通道:工具概览与边界
模拟联调通道是一个独立部署的 mock 服务:它扮演三方支付平台,接收 DaxPay 通道子应用的请求,按规则给出支付、退款、分账等交易结果,再按主应用配置的地址把异步回调推回去。整个链路不依赖任何真实通道的 SDK、账号和证书,因此可以在通道还没下号时先把平台侧的下单、回调、对账、退款全部跑通。
三类典型用途:
- 开发联调:新接入方式、新业务场景先在本机跑通,再换真实通道;
- 演示 POC:给客户演示支付全流程,不碰真钱;
- 能力试验田:收银台、回调重试、对账差异这些平台能力,用它当可控的对端来演练。
与「模拟通道」相关的三个概念
文档里出现的「模拟通道」不是同一个东西,先分清再往下看:
| 概念 | 是什么 | 谁提供 |
|---|---|---|
模拟通道产品 mock_pay / mock_isv | 平台侧的通道主数据与支付产品,决定「这笔单可以路由到 mock」 | 主应用(随数据集导入) |
| 通道适配模块 | 主应用 daxpay-channel-mock 编排模块 + 通道子应用的 mock 实现,负责按通道协议调用 mock 服务 | 主应用、dax-pay-channel-one |
| 模拟联调通道(本工具) | 扮演三方平台的独立服务,带管理台,可以裁决交易结果、补发回调、造对账差异 | 独立进程,本栏文档的对象 |
三者的调用关系是固定的:主应用 → 通道子应用 → 模拟联调通道。你不需要为了联调另外写代码,要做的是把这条链路上的路由、商户和回调地址配好,见接入配置。
演示模式下不用手工拉起
运维面板的「演示模式」部署会在业务容器之外额外拉起模拟通道服务(basic 组的 mock 组件仓),并装载演示数据集,开箱即可下单。手工部署与自定义场景见接入配置。
能力地图
| 能力 | 说明 |
|---|---|
| 支付 | 4 个付款方渠道 × 9 种拉起方式,另支持聚合支付(一码多付) |
| 退款 | 全额与部分退款;微信退款默认「处理中」,用于演练异步回调 |
| 分账 | 纯查询式交易,按金额尾号规则判定,无回调 |
| 转账 | 管理台内建单与查询;网关不提供转账端点,平台侧不会调用 |
| 预授权 | 冻结 → 请款 / 解冻,管理台可推终态与补发回调 |
| 对账 | 可造三类常见差异,导出符合契约的对账文件 |
| 进件 / 终端 | 服务商(ISV)进件、终端台账等能力按网关契约模拟 |
| 微信拟真 | 微信授权页、微信支付页、openid 校验等拟真流程 |
| 回调 | 终态自动回调、失败重试、人工补发,全部留痕可查 |
五分钟最短路径
- 拉起 mock 服务(
mvnd spring-boot:run,默认 10400); - 在运营端建一个使用「模拟支付」产品的通道商户,通道商户号用内置种子
MOCKM99999或自建; - 把该通道商户纳入通道路由;
- 确认运营端「平台配置 → 访问地址」填的是 mock 可达的主应用地址;
- 下一笔单,打开返回的确认页点「支付成功」,看主应用订单是否变成功、回调是否送达。
每一步的字段与失败现象见接入配置。
使用边界
只部署在开发机或可信内网
模拟联调通道的管理台提供强制改单、补发回调、冻结主体等危险操作,只能部署在开发机或可信内网,不得暴露公网。生产环境的主应用不会装配 mock 编排模块,误配 mock 路由时下单会直接报「产品策略不存在」。
管理台默认账号是 mock / mock(可改可关),浏览器登录后是长效 Cookie,脚本可直接用 Basic 头。付款人用的独立页面(收款确认、模拟支付、付款码)匿名放行,演示扫码链路不会被登录页挡住。