简体中文
模拟联调通道:接入配置
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 步:验证首笔
- 用一个已绑 mock 路由的应用下单(任意扫码类支付方式);
- 拿返回的
payBody打开收款确认页; - 点「确认支付成功」,页面回显回调送达状态;
- 回主应用订单列表,订单应为成功,资金凭证的渠道为 mock。
首笔通了就说明主应用 → 通道子应用 → mock → 回调这条链路完整。想造失败、超时、掉回调,见场景规则与运行开关与交易与人工裁决。
失败表现对照
| 现象 | 原因 |
|---|---|
| 下单报「产品策略不存在」 | 主应用跑在 PROD 模式,mock 编排模块整体未装配 |
| 下单报「模拟通道商户未注册」(10013) | mock 侧档案缺失:SQLite 库重建后没种子数据,或通道商户号与 mock 侧不一致 |
| 路由候选里没有模拟通道 | 能力主数据缺失(纯净数据集),或路由策略没保存成功 |
| 确认页打不开 / 手机扫码 404 | 确认页地址基于 mock 服务生成,手机与 mock 不在同一网络 |
| 支付成功但订单不动 | 回调地址未配置或不可达,看订单详情里的回调记录 |
| 规则不生效 | 判定链优先级被更高层覆盖,见场景规则与运行开关 |