通道路由
商户在同一条通道下可能有多个收款账户(通道商户)。通道路由回答的问题是:一笔支付请求进来,该走哪个通道商户收款。路由按应用生效,在商户代管的应用工作台中配置;配置好之后商户下单、网关收款都会按它自动分发。
路由如何工作
- 自动分发:下单请求没有指定通道商户时,系统按该应用的路由配置匹配,回填产品、通道商户与支付能力后再进通道。
- 确定性映射:一个渠道(或支付方式)只对应一个通道商户,当前版本没有轮询、权重、优先级等负载均衡策略。
- 直接指定会跳过路由:网关支付的「直接指定」模式、或接口调用显式传入通道商户时,不走路由配置。
- 首次打开路由页会自动初始化一条默认策略(按渠道默认模式),但不会配任何通道商户,需要手动完成配置。
入口:商户管理 → 商户列表 → 管理 → 商户工作台 → 应用工作台 → 「通道路由」卡片。路由页必须从应用工作台进入(携带商户与应用参数),直接访问会提示缺参。
两种配置维度
| 维度 | 配置粒度 | 每条配置的要素 | 适合场景 |
|---|---|---|---|
| 按渠道默认 | 支付渠道(微信/支付宝/银联/抖音…) | 渠道 → 通道商户 | 每条通道一个收款账户,简单省心 |
| 按支付方式 | 具体支付方式(如微信 JSAPI、微信扫码、支付宝 H5) | 支付方式 → 通道商户 + 支付能力(两者必须成对) | 同一通道下不同支付方式要分流到不同账户 |
- 按渠道默认时,支付能力由产品在运行时自动推导,无需配置;
- 两种维度互斥,同一时刻只有一种「生效模式」。切换维度配完后,必须点 「设为当前生效」 并确认,否则运行时仍按原来的模式解析——只切换单选钮不会生效。
- 生效中的模式会在工具条上标注「生效中」。
配置操作
按渠道默认(首次配置)
- 从应用工作台进入通道路由页(首次进入自动创建默认策略,模式为按渠道默认);
- 点右上角「编辑」,在每个支付渠道卡片中选择该渠道的通道商户(可只配部分渠道,候选只列出本商户已启用且产品匹配的通道商户);
- 「保存」并确认覆盖;
- 若生效模式不是「按渠道默认」,点「设为当前生效」。
按支付方式(精细分流)
- 点「编辑」,把「配置维度」切到「按支付方式」;
- 按渠道分组逐行选择「通道商户 + 支付能力」,两者同时选或同时留空,不能只填一个;不用的行留空即可;
- 「保存」并确认覆盖;
- 点「设为当前生效」,确认后下单即按支付方式解析。
成对规则
「通道商户 + 支付能力」必须成对填写,页面与后端都会拦截只填其一的保存。每种支付方式全局只能配置一行。
命中预览
配置完成后不用真发起支付来验证:在网关支付配置页,当支付形态选择「跟随通道路由」或「指定支付方式」时,每个组合会显示路由命中预览列——直接告诉你这样下单会走哪个通道商户、哪个能力;未配置的组合显示「未配置」,页头还有「路由命中 x/y」的覆盖率统计。配置完路由来这里扫一眼覆盖率,比试单更快。
常见拦截与排查
下单被路由拒绝时,报错会明确指向原因,对照处理:
| 报错/现象 | 原因 | 处理 |
|---|---|---|
| 通道商户与产品环境不匹配 | 沙箱通道商户配在了生产产品下(或相反);通道商户的环境标识创建时固化,不随产品切换 | 为目标环境另建通道商户,更新路由 |
| 通道商户已禁用 | 被停用的通道商户不会被路由命中 | 启用该通道商户,或换路由指向 |
| 支付产品已停用 | 停用产品不允许发起新支付 | 到支付产品配置启用产品 |
| 支付渠道未配置通道商户 | 按渠道默认模式下,该渠道没有配置 | 补配对应渠道的路由 |
配置健康检查
商户工作台的配置检查会提示「已启用的应用缺少路由策略」类告警,按提示进路由页配置即可消除。路由配置保存后立即生效,无需重启。