Skip to content

网关支付 ​

更新时间:2026/10/9 21:51:38

网关支付是平台提供的托管收款页能力:商户只需调用网关预下单接口拿到一个链接或二维码,用户打开后由平台的页面完成支付方式选择与收款。两种形态:统一收银台(用户在页面上选支付方式)与聚合扫码(一码多付,按扫码环境自动识别)。

两种形态 ​

形态网关支付类型适用场景
统一收银台cashierPC / H5 收银台,用户在落地页选择支付方式(微信、支付宝等)
聚合扫码aggregate印在物料上的静态二维码,微信 / 支付宝 / 云闪付 / 抖音扫同一个码,自动识别环境跳转对应支付

两种形态都通过 POST /unipay/gateway/pre-pay(网关预下单)发起;码牌(见支付码牌与终端)生成的静态码同样走聚合扫码链路。

与普通支付的区别

普通支付(/unipay/pay)由业务系统自己确定支付方式并处理各环境的跳转;网关支付把「选方式、适配环境」这件事交给平台的托管页,业务系统只需管理一个链接。开发调试可用「支付调试(网关)」页模拟。

配置入口 ​

菜单路径:商户端 → 商户中心 → 支付配置 → 应用配置 → 进入应用 → 网关支付配置(运营端在商户工作台 → 应用管理 → 应用配置内,同一功能)

网关支付配置是应用级的(每个应用独立配置)。

配置模型 ​

配置层级 ​

层级说明
跟随通道路由(auto)最省心:按用户打开页面的环境自动推导支付方式,再走应用的通道路由解析通道商户
指定支付方式(method)每个打开环境指定一个支付方式(如微信环境用 wechat_mini),再走应用路由
直接指定(direct)最精确:每个打开环境直接指定「通道商户 + 支付能力」,跳过应用路由

建议从 auto 开始,遇到路由不满足需求(如某环境要走指定通道商户)再逐格调整。

环境 × 形态矩阵 ​

配置以矩阵形式呈现:4 个打开环境(微信 / 支付宝 / 云闪付 / 抖音——由扫码或浏览器的 UA 决定)× 2 种形态(H5 / 小程序)。auto 层级下系统按环境给出默认支付方式(如微信 H5 用 wechat_jsapi、微信小程序用 wechat_mini、支付宝 H5 用 alipay_qr)。

路由命中预览 ​

配置区提供路由命中预览:逐格展示当前配置会命中的通道商户与支付能力、路由模式(基础 / 场景)与覆盖情况(已配置数 / 缺口),配置不完整一目了然。预览中的缺口可跳转「通道路由」页补配。

收银台配置 ​

统一收银台落地页的展示内容在「应用工作台 → 收银台配置」中自定义,与上面的通道路由配置相互独立:

  • 按终端分桶配置:H5(按打开环境细分浏览器 / 微信 / 支付宝 / 云闪付 / 抖音五档)、Web(扁平列表)、小程序(按环境四档);
  • 每个桶内配置支付项的展示与解析模式(按支付方式 / 直接指定)。

完整接入流程 ​

  1. (可选)应用工作台 → 网关支付配置:选择配置层级,按需调整环境 × 形态矩阵;
  2. (可选)收银台配置:调整落地页展示;
  3. 业务系统调用网关预下单,或直接使用码牌承载聚合扫码链接;
  4. 用「开发调试 → 支付调试(网关)」验证:选择网关支付类型提交后,返回网关落地页 URL(H5,可扫码或直接打开)与小程序映射链接,检查实际支付链路。

相关章节 ​