收银台小程序:发布上线
收银台小程序按平台分别发布(微信 / 支付宝 / 抖音各一个小程序)。核心是两件事:域名验证(证明域名归你)与普通链接二维码规则(让现有二维码能拉起小程序)。编译与上传操作见跨端应用。
上线检查单
- 平台注册小程序主体并获得 AppId;
- 完成域名验证(校验文件上传);
- 配置普通链接二维码规则;
- 配置 request 合法域名;
- 编译上传、提审、发布。
第一步:注册与 AppId
在微信 / 支付宝 / 抖音的开放平台分别注册小程序主体,拿到各自的 AppId,配置到工程的平台参数中(三端 AppId 独立)。一个平台发一个小程序,互不影响。
第二步:域名验证
微信要求小程序调用的域名必须完成归属验证:
- 微信公众平台下发校验文件(
MP_verify_xxx.txt); - 把文件内容在运营端「支付配置 → 域名校验文件」上传托管(商户也可在商户端自助上传,见商户中心);
- 在微信公众平台配置业务域名时,微信会访问该文件完成校验。
详细说明见通道对接 - 域名校验文件。
第三步:普通链接二维码规则(关键)
商家的收款二维码是已印好的普通链接二维码(内容是 https://域名/m/xxx 这样的 URL),小程序规则的作用是:扫码时微信 / 支付宝发现 URL 命中规则,直接拉起小程序对应页面,不需要专门的小程序码。
在微信公众平台的「普通链接二维码跳转小程序」中配置:
| 规则前缀 | 拉起的页面 |
|---|---|
https://域名/m/* | 码牌收款页 |
https://域名/cm/* | 统一收银台页 |
https://域名/am/* | 聚合支付页 |
- 三条规则分别配置,前缀按上表(域名 = 支付网关(H5)的部署域名);
- 配置时平台会下发随机校验文件,同样在运营端上传托管(同第二步);
- 支付宝在开放平台的「扫码进入小程序」做对应配置。
未配规则的后果
规则没配或没命中时,扫码打开的是 H5 引导页(提示改用钱包扫码),小程序不会被拉起——上线后务必用真码全链路验证一遍。
第四步:合法域名
在小程序后台把后端接口域名(支付网关域名)加入 request 合法域名,否则正式环境请求全部失败(开发工具里勾选「不校验域名」只对调试有效)。
第五步:编译、上传与审核
- 编译对应平台产物并上传(操作详见跨端应用);
- 提交平台审核:收款类小程序需如实填写类目与资质;
- 审核通过后发布。发布后用真实二维码验证三条链路(码牌 / 收银台 / 聚合)都能拉起小程序并完成付款。
兜底行为与排查
| 现象 | 原因与处理 |
|---|---|
| 扫码进的是 H5 引导页 | 二维码规则未命中:检查前缀拼写、域名一致性、小程序是否已发布 |
| 钱包内提示「收款小程序暂不可用」 | 同上(钱包环境命中了 H5 兜底页) |
| 正式环境请求失败 | request 合法域名没配 |
| 域名校验不通过 | 校验文件未上传或传错归属(平台 / 商户级) |