支付网关(H5)
支付网关是部署在支付网关域名上的前端工程:付款人看到的收款页、通道与钱包的授权回调、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 强制指定形态。各页面的具体交互见收款页面。