Skip to content

支付网关(H5) ​

更新时间:2026/10/14 19:28:48

支付网关是部署在支付网关域名上的前端工程:付款人看到的收款页、通道与钱包的授权回调、Web 端的三方登录中转、协议展示,都由它承接。它不只服务手机——电脑浏览器打开的网页收银台同样是它(同一工程内 PC / 移动两套页面自动适配)。后端「平台配置 → 端点配置」里的支付网关前端地址,指向的就是它。

它负责什么 ​

职责地址(网关域名下)谁在用详见
收款页面(统一收银台 / 码牌 / 聚合)/cashier/{订单号}、/h/{码牌编号}、/aggregate/{订单号}付款人收款页面
支付结果回跳/pay-result/{交易号}付款人收款页面
转账确认/transfer-confirm/{转账单号}收款人收款页面
支付认证落地/auth/wechat、/auth/alipay、/auth/douyin付款人(无感经过)认证与中转
代运营授权落地/isv-auth/alipay商家认证与中转
三方登录 / 绑定中转/auth/oauth-callback/...Web 管理端 / 商户端登录用户认证与中转
协议展示/protocol/{类型}付款人认证与中转

另有三个小程序兜底页:码牌 /m/{码牌编号}、聚合 /am/{订单号}、收银台 /cm/{订单号}——小程序链接在浏览器里打开时,展示「请用钱包扫码」的引导,不发起支付。

这些地址是谁生成的 ​

支付网关上的绝大多数地址不是前端自己拼的,而是后端按「支付网关前端地址」生成的:收款链接(预下单返回给商户系统的付款地址)、通道回跳的结果页、转账确认地址、认证授权的回跳路径、三方登录的透传入口,全部如此。

因此支付网关必须部署在与端点配置一致的支付网关域名之下,两边对得上,付款人与登录用户才不会被带到 404。这是它部署上的最大特殊性,详见部署与上线。

与收银台小程序的分工 ​

  • 微信 / 支付宝内扫商家出示的码 → 拉起收银台小程序付款;
  • 支付链接在浏览器打开(短信、邮件、网页按钮,手机或电脑均可)→ 支付网关的收款页付款;
  • 二维码命中小程序失败(小程序未发布、普通链接二维码规则未配置)→ 落到网关的兜底引导页,提示改用微信 / 支付宝扫码。

三类收款在两种形态下各有一套链接前缀(域名相同,路径不同):

收款方式支付网关(浏览器打开)收银台小程序(钱包内打开)
码牌/h/{码牌编号}/m/{码牌编号}
聚合支付/aggregate/{订单号}/am/{订单号}
统一收银台/cashier/{订单号}/cm/{订单号}

电脑与手机自适应 ​

同一链接按设备自动展示两套页面:手机浏览器走完整收银流程;电脑浏览器打开统一收银台是网页版收银页,码牌 / 聚合页显示「请用手机扫一扫」引导。调试时可在链接后加 ?device=pc / ?device=mobile 强制指定形态。各页面的具体交互见收款页面。

相关链接 ​