Skip to content

通道路由 ​

更新时间:2026/10/14 13:50:54

商户在同一条通道下可能有多个收款账户(通道商户)。通道路由回答的问题是:一笔支付请求进来,该走哪个通道商户收款。路由按应用生效,在商户代管的应用工作台中配置;配置好之后商户下单、网关收款都会按它自动分发。

路由如何工作 ​

  • 自动分发:下单请求没有指定通道商户时,系统按该应用的路由配置匹配,回填产品、通道商户与支付能力后再进通道。
  • 确定性映射:一个渠道(或支付方式)只对应一个通道商户,当前版本没有轮询、权重、优先级等负载均衡策略。
  • 直接指定会跳过路由:网关支付的「直接指定」模式、或接口调用显式传入通道商户时,不走路由配置。
  • 首次打开路由页会自动初始化一条默认策略(按渠道默认模式),但不会配任何通道商户,需要手动完成配置。

入口:商户管理 → 商户列表 → 管理 → 商户工作台 → 应用工作台 → 「通道路由」卡片。路由页必须从应用工作台进入(携带商户与应用参数),直接访问会提示缺参。

两种配置维度 ​

维度配置粒度每条配置的要素适合场景
按渠道默认支付渠道(微信/支付宝/银联/抖音…)渠道 → 通道商户每条通道一个收款账户,简单省心
按支付方式具体支付方式(如微信 JSAPI、微信扫码、支付宝 H5)支付方式 → 通道商户 + 支付能力(两者必须成对)同一通道下不同支付方式要分流到不同账户
  • 按渠道默认时,支付能力由产品在运行时自动推导,无需配置;
  • 两种维度互斥,同一时刻只有一种「生效模式」。切换维度配完后,必须点 「设为当前生效」 并确认,否则运行时仍按原来的模式解析——只切换单选钮不会生效。
  • 生效中的模式会在工具条上标注「生效中」。

配置操作 ​

按渠道默认(首次配置) ​

  1. 从应用工作台进入通道路由页(首次进入自动创建默认策略,模式为按渠道默认);
  2. 点右上角「编辑」,在每个支付渠道卡片中选择该渠道的通道商户(可只配部分渠道,候选只列出本商户已启用且产品匹配的通道商户);
  3. 「保存」并确认覆盖;
  4. 若生效模式不是「按渠道默认」,点「设为当前生效」。

按支付方式(精细分流) ​

  1. 点「编辑」,把「配置维度」切到「按支付方式」;
  2. 按渠道分组逐行选择「通道商户 + 支付能力」,两者同时选或同时留空,不能只填一个;不用的行留空即可;
  3. 「保存」并确认覆盖;
  4. 点「设为当前生效」,确认后下单即按支付方式解析。

成对规则

「通道商户 + 支付能力」必须成对填写,页面与后端都会拦截只填其一的保存。每种支付方式全局只能配置一行。

命中预览 ​

配置完成后不用真发起支付来验证:在网关支付配置页,当支付形态选择「跟随通道路由」或「指定支付方式」时,每个组合会显示路由命中预览列——直接告诉你这样下单会走哪个通道商户、哪个能力;未配置的组合显示「未配置」,页头还有「路由命中 x/y」的覆盖率统计。配置完路由来这里扫一眼覆盖率,比试单更快。

常见拦截与排查 ​

下单被路由拒绝时,报错会明确指向原因,对照处理:

报错/现象原因处理
通道商户与产品环境不匹配沙箱通道商户配在了生产产品下(或相反);通道商户的环境标识创建时固化,不随产品切换为目标环境另建通道商户,更新路由
通道商户已禁用被停用的通道商户不会被路由命中启用该通道商户,或换路由指向
支付产品已停用停用产品不允许发起新支付到支付产品配置启用产品
支付渠道未配置通道商户按渠道默认模式下,该渠道没有配置补配对应渠道的路由

配置健康检查

商户工作台的配置检查会提示「已启用的应用缺少路由策略」类告警,按提示进路由页配置即可消除。路由配置保存后立即生效,无需重启。

相关链接 ​