Skip to content

模拟联调通道:接入配置 ​

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

mock 侧开箱即有内置档案与默认规则,需要动手的是主应用侧。下面按顺序配置一遍,配置完就能下单。

前置检查 ​

项要求
主应用以 dev 模式启动(daxpay.platform.deployment.mode=DEV),PROD 不装配 mock 模块
通道子应用dax-pay-channel-one 已启动(20100)
mock 服务已启动,默认 10400;curl http://127.0.0.1:10400/health 可通
数据库演示数据集(data-demo.sql)——mock 通道主数据与演示商户都在里面;纯净数据集 data.sql 不含 mock 通道,需要换数据集或按主数据表自行补齐

启动 mock 服务:

bash
# 仓库根, dev profile, 端口 10400
mvnd spring-boot:run

只改前端时才需要单独跑管理台 dev server(10500,/mock 前缀代理到 10400);日常联调用后端自带的静态产物即可。改过管理台页面必须重新 cd ui && pnpm build,否则改动只存在于 dev server。

第 1 步:建模拟通道商户 ​

运营端「通道商户」页新增,产品选「模拟支付」,通道商户号填内置种子 MOCKM99999(或自建任意号),其余凭证资料全部留空——mock 是零资料接入,不需要任何密钥证书。

第 2 步:把模拟通道纳入路由 ​

运营端「通道路由」为应用配置策略,把上一步的通道商户纳入候选:

  • 基础模式(按渠道默认):在微信 / 支付宝 / 银联 / 抖音任意渠道下绑定该通道商户。mock 产品策略声明覆盖平台全部支付方式,四个渠道任意方式下单都能路由过来;
  • 场景模式(按支付方式):在对应支付方式行选择该通道商户与能力。保存时的候选校验依赖能力主数据,缺行则该方式不会出现在候选里。

第 3 步:配置回调地址 ​

运营端「平台配置 → 访问地址」里的后端访问地址必须是 mock 服务能访问到的主应用地址。mock 发回调时用它拼 URL,本机联调就是 http://127.0.0.1:9999。没配或不可达时,支付能成功、回调永远发不回来。

第 4 步:确认网关地址与密钥 ​

  • 通道子应用 → mock 服务的基地址默认 http://127.0.0.1:10400,配置项 mock.gateway.base-url;mock 不在本机时改这一项;
  • 网关验签只有一套全局密钥对,本机默认链路无需额外交换。服务商(ISV)模式要在运营端「模拟服务商」里粘贴管理台「系统 → 联调材料」页的商户私钥与平台公钥两件套。

第 5 步:验证首笔 ​

  1. 用一个已绑 mock 路由的应用下单(任意扫码类支付方式);
  2. 拿返回的 payBody 打开收款确认页;
  3. 点「确认支付成功」,页面回显回调送达状态;
  4. 回主应用订单列表,订单应为成功,资金凭证的渠道为 mock。

首笔通了就说明主应用 → 通道子应用 → mock → 回调这条链路完整。想造失败、超时、掉回调,见场景规则与运行开关与交易与人工裁决。

失败表现对照 ​

现象原因
下单报「产品策略不存在」主应用跑在 PROD 模式,mock 编排模块整体未装配
下单报「模拟通道商户未注册」(10013)mock 侧档案缺失:SQLite 库重建后没种子数据,或通道商户号与 mock 侧不一致
路由候选里没有模拟通道能力主数据缺失(纯净数据集),或路由策略没保存成功
确认页打不开 / 手机扫码 404确认页地址基于 mock 服务生成,手机与 mock 不在同一网络
支付成功但订单不动回调地址未配置或不可达,看订单详情里的回调记录
规则不生效判定链优先级被更高层覆盖,见场景规则与运行开关