Skip to content

收银台小程序:发布上线 ​

更新时间:2026/10/15 17:44:21

收银台小程序按平台分别发布(微信 / 支付宝 / 抖音各一个小程序)。核心是两件事:域名验证(证明域名归你)与普通链接二维码规则(让现有二维码能拉起小程序)。编译与上传操作见跨端应用。

上线检查单 ​

  1. 平台注册小程序主体并获得 AppId;
  2. 完成域名验证(校验文件上传);
  3. 配置普通链接二维码规则;
  4. 配置 request 合法域名;
  5. 编译上传、提审、发布。

第一步:注册与 AppId ​

在微信 / 支付宝 / 抖音的开放平台分别注册小程序主体,拿到各自的 AppId,配置到工程的平台参数中(三端 AppId 独立)。一个平台发一个小程序,互不影响。

第二步:域名验证 ​

微信要求小程序调用的域名必须完成归属验证:

  1. 微信公众平台下发校验文件(MP_verify_xxx.txt);
  2. 把文件内容在运营端「支付配置 → 域名校验文件」上传托管(商户也可在商户端自助上传,见商户中心);
  3. 在微信公众平台配置业务域名时,微信会访问该文件完成校验。

详细说明见通道对接 - 域名校验文件。

第三步:普通链接二维码规则(关键) ​

商家的收款二维码是已印好的普通链接二维码(内容是 https://域名/m/xxx 这样的 URL),小程序规则的作用是:扫码时微信 / 支付宝发现 URL 命中规则,直接拉起小程序对应页面,不需要专门的小程序码。

在微信公众平台的「普通链接二维码跳转小程序」中配置:

规则前缀拉起的页面
https://域名/m/*码牌收款页
https://域名/cm/*统一收银台页
https://域名/am/*聚合支付页
  • 三条规则分别配置,前缀按上表(域名 = 支付网关(H5)的部署域名);
  • 配置时平台会下发随机校验文件,同样在运营端上传托管(同第二步);
  • 支付宝在开放平台的「扫码进入小程序」做对应配置。

未配规则的后果

规则没配或没命中时,扫码打开的是 H5 引导页(提示改用钱包扫码),小程序不会被拉起——上线后务必用真码全链路验证一遍。

第四步:合法域名 ​

在小程序后台把后端接口域名(支付网关域名)加入 request 合法域名,否则正式环境请求全部失败(开发工具里勾选「不校验域名」只对调试有效)。

第五步:编译、上传与审核 ​

  1. 编译对应平台产物并上传(操作详见跨端应用);
  2. 提交平台审核:收款类小程序需如实填写类目与资质;
  3. 审核通过后发布。发布后用真实二维码验证三条链路(码牌 / 收银台 / 聚合)都能拉起小程序并完成付款。

兜底行为与排查 ​

现象原因与处理
扫码进的是 H5 引导页二维码规则未命中:检查前缀拼写、域名一致性、小程序是否已发布
钱包内提示「收款小程序暂不可用」同上(钱包环境命中了 H5 兜底页)
正式环境请求失败request 合法域名没配
域名校验不通过校验文件未上传或传错归属(平台 / 商户级)

相关链接 ​