在餐饮外卖场景中，二维码是连接线下顾客与线上小程序的重要桥梁。无论是门店张贴的点餐码、餐桌上的扫码点餐码，还是活动海报上的推广码，商家都希望顾客扫一扫就能直接进入小程序指定页面。本文将详细介绍如何在海狐外卖系统中配置普通二维码跳转微信小程序和支付宝小程序，帮助您快速打通线上线下流量。
一、为什么需要配置二维码跳转小程序
在日常经营中，商家经常会遇到这样的场景：
- 门店门口张贴了二维码，顾客扫码后希望直接跳转到小程序首页浏览商家信息
- 餐桌上放置了扫码点餐码，顾客扫码后希望直接进入点餐页面
- 商家在微信群或朋友圈分享了二维码，希望用户扫码后直达某个活动分类
- 收银台放置了当面付二维码，顾客扫码后直接进入付款页面
如果这些二维码只是普通链接，没有与小程序关联配置，用户扫码后可能只能打开一个网页，体验远不如直接进入小程序流畅。通过微信和支付宝提供的”普通链接二维码打开小程序”功能，商家可以将已有的线下二维码与小程序页面进行绑定，实现扫码直达的效果。
二、微信小程序二维码配置流程
2.1 开发配置
首先登录微信小程序管理后台，进入 开发管理 → 开发设置 → 扫普通链接二维码打开小程序。这一步的核心目的是告诉微信：当用户扫描某个特定域名的二维码时，应该打开哪个小程序页面。
在这里，您需要配置二维码的规则地址。规则地址就是您二维码中链接的域名，需要确保这个域名已经通过 ICP 备案，并且您有权限在该域名的根目录下放置文件。
2.2 配置规则与校验文件
微信为了确认您对该域名拥有所有权，会要求您在域名根目录下放置一个随机生成的校验文件。具体操作如下：
- 在微信小程序后台生成校验文件，下载到本地
- 将校验文件上传到您二维码链接对应域名的根目录下（即能通过
https://您的域名/校验文件名直接访问到） - 在微信后台点击”确认校验”，验证通过后即可正常使用
在海狐外卖系统中，二维码跳转域名需要在后端配置文件中进行设置。进入后端代码根目录下的 .env 文件，找到 [QRCODE] 配置段：
[QRCODE]
DEFAULTURL = "https://您的域名"确保这里的域名与您在微信后台配置的二维码域名一致，否则二维码扫码后将无法正常跳转。
2.3 常用二维码链接地址
配置完成后，您可以根据不同场景生成对应的二维码链接。以下是海狐外卖系统中常用的几种链接地址：
打开小程序首页
用于门店门口、宣传海报等场景，扫码后直接进入小程序首页。链接格式为：
http://您的域名/app/kongma.php?id=平台ID
其中 id 代表平台 ID，不同代理区域的平台 ID 不同，请根据实际情况替换。对应的小程序页面路径为 pages/home/home。
打开某个商品分类
用于导航栏分类推广，扫码后直接进入某个商品分类列表。链接格式为：
https://您的域名/app/store_cagegory.php?uniacid=平台ID&code=分类编码
对应的小程序页面路径为 pages/home/category 或 store-page/store-list/index。
堂食扫码点餐空码
用于餐桌扫码点餐场景，扫码后直接进入堂食点餐页面。链接格式为：
https://您的域名/app/kongma.php?uniacid=平台ID&code=桌台编码
对应的小程序页面路径为 store-page/tangshi/index 或新版 store-page/product-showcase/template-1。
打开指定店铺点餐页面
用于针对某个店铺的推广，扫码后直接进入该店铺的点餐页。链接格式为：
https://您的域名/app/storekongma.php?uniacid=平台ID&code=店铺编码
对应的小程序页面路径为 store-page/template-skyline/template-skyline。
当面付收款
用于收银台的当面付场景，扫码后直接进入付款页面。链接格式为：
https://您的域名/app/paybillkongma.php?uniacid=平台ID&code=编码
对应的小程序页面路径为 plugin-page/paybill/index。
三、支付宝小程序二维码配置流程
支付宝小程序同样支持普通二维码跳转功能，商家不需要更换已有的线下二维码，只需在支付宝后台配置关联规则即可。
3.1 准入条件
支付宝的这项功能对企业和个人开发者均开放，只要您的小程序版本已上传至支付宝开放平台，就可以在管理后台进行配置。
3.2 配置入口
登录支付宝商家自运营中心或开发者中心控制台，进入小程序管理后台，找到 推广获客 → 码管理（新版入口），或 码管理 页面（旧版入口保留）。目前支付宝小程序最多支持设置 20 条二维码关联规则。
3.3 二维码地址与匹配规则
支付宝要求二维码地址必须通过 ICP 备案验证，支持以 http、https、ftp 开头的链接。匹配规则支持两种方式：
- 精确匹配：只有完全匹配的链接才会触发跳转
- 模糊匹配：符合域名规则的链接都会触发跳转（推荐选择此方式，兼容性更好）
3.4 校验文件放置
与微信类似，支付宝也需要校验域名所有权。您需要下载支付宝生成的随机校验文件，并将其放置于二维码地址域名的根目录下。放置完成后，在后台点击确认校验即可。请注意，校验通过后请勿删除该文件，否则会导致验证失效。
3.5 功能页面配置与调试
在配置二维码规则时，您需要指定扫码后打开的小程序功能页面路径，例如 pages/index/index。配置完成后，建议使用支付宝扫描系统生成的测试二维码进行调试。测试二维码可以对体验版和开发版生效，方便您在正式发布前验证功能是否正常。
四、常见问题（FAQ）
Q1：配置完成后，用户扫码还是打不开小程序，显示网页怎么办？
请依次检查以下几点：校验文件是否正确放置在域名根目录且未删除；.env 文件中的 DEFAULTURL 是否与二维码域名一致；微信小程序后台的规则地址是否正确填写；如果都确认无误，尝试清除微信/支付宝缓存后重新扫码测试。
Q2：一个域名可以同时配置微信小程序和支付宝小程序吗？
可以。微信和支付宝的校验文件分别独立，您只需将两个平台的校验文件都上传到同一个域名根目录下即可。但请注意，两个平台的小程序页面路径可能不同，需要分别配置对应的功能页面。
Q3：二维码链接中的平台 ID 和店铺编码在哪里查看？
平台 ID 可以在海狐外卖系统总后台的代理区域管理中找到。店铺编码（sid）可以在商户列表或店铺详情中查看。如果您不确定具体数值，可以联系系统管理员协助查询。
Q4：已经印刷好的二维码还能用吗？
可以。普通二维码跳转小程序的核心优势就是无需更换已有的线下二维码，只需在小程序后台配置关联规则即可。但前提是二维码中的链接域名已经通过 ICP 备案，且您拥有在该域名下放置校验文件的权限。
Q5：最多可以配置多少条二维码规则？
微信小程序和支付宝小程序都支持多条规则配置。其中支付宝小程序最多支持 20 条规则，微信小程序的规则数量相对灵活，建议根据实际业务场景合理规划，将常用的几类页面配置好即可满足大部分需求。
五、相关功能推荐
配置好二维码跳转后，您还可以结合以下功能进一步提升顾客体验：
- 【店内扫码点餐】 快速导入桌台信息并生成扫码点餐空码，顾客扫码即可自助点餐，减少服务员工作量
- 【当面付收银】 配置收款空码，顾客扫码直接付款，支持微信、支付宝等多种支付方式
- 【页面装修】 自定义小程序首页布局，让顾客扫码进入后第一眼就能看到吸引人的活动和推荐商品