Skip to content

模拟联调通道:工具概览与边界 ​

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

模拟联调通道是一个独立部署的 mock 服务:它扮演三方支付平台,接收 DaxPay 通道子应用的请求,按规则给出支付、退款、分账等交易结果,再按主应用配置的地址把异步回调推回去。整个链路不依赖任何真实通道的 SDK、账号和证书,因此可以在通道还没下号时先把平台侧的下单、回调、对账、退款全部跑通。

三类典型用途:

  • 开发联调:新接入方式、新业务场景先在本机跑通,再换真实通道;
  • 演示 POC:给客户演示支付全流程,不碰真钱;
  • 能力试验田:收银台、回调重试、对账差异这些平台能力,用它当可控的对端来演练。

与「模拟通道」相关的三个概念 ​

文档里出现的「模拟通道」不是同一个东西,先分清再往下看:

概念是什么谁提供
模拟通道产品 mock_pay / mock_isv平台侧的通道主数据与支付产品,决定「这笔单可以路由到 mock」主应用(随数据集导入)
通道适配模块主应用 daxpay-channel-mock 编排模块 + 通道子应用的 mock 实现,负责按通道协议调用 mock 服务主应用、dax-pay-channel-one
模拟联调通道(本工具)扮演三方平台的独立服务,带管理台,可以裁决交易结果、补发回调、造对账差异独立进程,本栏文档的对象

三者的调用关系是固定的:主应用 → 通道子应用 → 模拟联调通道。你不需要为了联调另外写代码,要做的是把这条链路上的路由、商户和回调地址配好,见接入配置。

演示模式下不用手工拉起

运维面板的「演示模式」部署会在业务容器之外额外拉起模拟通道服务(basic 组的 mock 组件仓),并装载演示数据集,开箱即可下单。手工部署与自定义场景见接入配置。

能力地图 ​

能力说明
支付4 个付款方渠道 × 9 种拉起方式,另支持聚合支付(一码多付)
退款全额与部分退款;微信退款默认「处理中」,用于演练异步回调
分账纯查询式交易,按金额尾号规则判定,无回调
转账管理台内建单与查询;网关不提供转账端点,平台侧不会调用
预授权冻结 → 请款 / 解冻,管理台可推终态与补发回调
对账可造三类常见差异,导出符合契约的对账文件
进件 / 终端服务商(ISV)进件、终端台账等能力按网关契约模拟
微信拟真微信授权页、微信支付页、openid 校验等拟真流程
回调终态自动回调、失败重试、人工补发,全部留痕可查

五分钟最短路径 ​

  1. 拉起 mock 服务(mvnd spring-boot:run,默认 10400);
  2. 在运营端建一个使用「模拟支付」产品的通道商户,通道商户号用内置种子 MOCKM99999 或自建;
  3. 把该通道商户纳入通道路由;
  4. 确认运营端「平台配置 → 访问地址」填的是 mock 可达的主应用地址;
  5. 下一笔单,打开返回的确认页点「支付成功」,看主应用订单是否变成功、回调是否送达。

每一步的字段与失败现象见接入配置。

使用边界 ​

只部署在开发机或可信内网

模拟联调通道的管理台提供强制改单、补发回调、冻结主体等危险操作,只能部署在开发机或可信内网,不得暴露公网。生产环境的主应用不会装配 mock 编排模块,误配 mock 路由时下单会直接报「产品策略不存在」。

管理台默认账号是 mock / mock(可改可关),浏览器登录后是长效 Cookie,脚本可直接用 Basic 头。付款人用的独立页面(收款确认、模拟支付、付款码)匿名放行,演示扫码链路不会被登录页挡住。

继续阅读 ​