更新时间：2024-10-23 18:08:28配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档完成 接入准备 后，商家/服务商可根据本文指引快速接入 小程序码。注意事项●小程序必须是 上线 状态，才可通过二维码跳转。●支付宝扫描二维码将按以下匹配规则控制跳转：○页面地址：指定小程序中能访问的路径地址，默认为小程序的凯发k8官方网娱乐官方首页地址。○启动参数：小程序启动时候需要带入的参数，可以为空。启动参数可以通过 options.query 获取，格式为 key1=value1&key2=value2。○普通二维码：商家的开发者自行对网页链接进行编码后生成的二维码。生成二维码每个小程序都有一个默认的小程序二维码，目标地址是 小程序凯发k8官方网娱乐官方首页。开发者可根据需求，生成跳转至指定页面的二维码。pc 端生成1登录 > 控制台，进入对应小程序详情页 > 获客 > 小程序码。 2点击左上角 添加异形码 按钮，添加异形码 页面填写相关信息，完成后点击 提交。 3完成添加码操作后，点击操作列 下载 可下载小程序码。○下载圆形小程序码时，可设置颜色，也可以针对不同使用场景选择下载尺寸。○下载异形码：提供白色与透明两种背景圆形码，白色背景圆形码可以直接使用，透明背景圆形码可以与自身物料搭配进行使用。○下载码物料素材：包含更多物料相关的示例及使用场景，欢迎下载使用。○申请电子物料：可前往物料中心，申请官方提供的电子物料。○生成 ai 海报：支付宝扫码打开 ai 海报设计机器人，欢迎扫码使用。 接口生成创建超过 20 个小程序二维码。在服务端接口调用 ，生成小程序推广二维码图片链接。说明：●一个小程序可通过使用该二维码接口获取无限个带参数的二维码。●该接口返回 qr_code_url （二维码链接）若直接在浏览器打开会下载二维码，如需直接在浏览器打开二维码可在链接后添加 .png 或 .jpg 图片后缀。●该接口返回 qr_code_url 可直接在小程序中打开展示二维码。请求示例重要入参说明●url_param：必填，商家小程序中能访问到的页面路径，用户扫码后将跳转至此页面。仅需传入小程序页面地址，如：page/component/component-pages/view/view。●query_param：必填，小程序的启动参数。打开小程序后可在小程序 app.js 页面使用 onlaunch 及 onshow 方法获取。●describe：必填，对二维码的描述。响应示例重要响应说明●qr_code_url：必填，二维码图片链接地址。○若直接在浏览器打开本链接会下载二维码，如需直接在浏览器打开二维码可在链接后添加 .png 或 .jpg 图片后缀。○本链接直接在小程序中打开可展示二维码。○接口生成的二维码图片永久有效。获取启动参数用户使用支付宝扫描二维码访问商家小程序时，开发者可在 app.js 中的 onshow 和 onlaunch 方法中获取二维码携带的启动参数。 示例代码输入参数●页面地址：page/component/component-pages/view/view●启动参数：x=1&y=2获取启动参数准备获取启动参数中 x 的值。app.js示例效果关联普通二维码为便于商家兼容线下已铺设的“普通链接二维码”，支付宝开放扫“普通链接二维码”后直接进入小程序内商家指定页面的能力。商家需将其“普通链接二维码”对应的“二维码链接地址”与支付宝小程序页面进行规则关联，用户使用支付宝扫码后，支付宝会自动按照商家已配置的关联规则跳转至小程序内商家指定页面。其中“二维码链接地址”需完成域名备案并按支付宝流程要求完成所属权校验。配置指南1登录 进入对应小程序详情页 > 小程序码 > 关联普通二维码，点击 添加。 2填写信息说明。○匹配规则：必填。■若选择 精确匹配，则用户所扫二维码链接地址与关联规则的二维码链接地址 完全一致 时，才能跳转至小程序内商家指定页面。在精确匹配模式下，完全相同的二维码地址仅能配置一个关联规则，不支持配置两个（含）以上精确匹配关联规则。■若选择 模糊匹配，则用户所扫二维码链接地址与配置规则中的二维码链接地址 前缀一致 时，就能跳转至小程序内商家指定页面。同一小程序下，完全相同的二维码地址仅能配置一个模糊匹配关联规则，不支持配置两个（含）以上模糊匹配关联规则，报错提示为 码路由规则冲突；不同小程序间，完全相同或相互包含的二维码地址仅能配置一个模糊匹配关联规则，不支持配置两个（含）以上模糊匹配关联规则，报错提示为 此规则已被其他小程序使用。（相互包含指一个二维码地址链接为另一个二维码地址链接的前缀，如地址链接 http://www.test.com/123/456 包含地址链接 http://www.test.com/123）。○二维码地址：必填。■该二维码由商家的开发者自行对网页链接进行编码后生成，通常展现于线下已铺设物料。■二维码地址中的域名须通过icp备案验证，不可使用未经icp备案的域名或ip地址。■支持 http、https、ftp 开头的链接。■长度限 128 个字符（含）以内。○二维码地址所属权校验：必经。■点击 下载校验文件，获取校验文件。■将校验文件放置于二维码地址域名的根目录下。■页面点击 发起确认，系统将自动检查校验文件是否可正常访问，如能正常访问，则完成所属权确认（为保持校验通过的状态，校验成功后请不要删除校验文件）。○小程序功能页：必填。■该地址对应扫码后跳转的第一个页面，须为当前小程序的页面。■填写内容为页面 url 中的 page 参数，填写方式可查看 小程序scheme链接介绍 中 url 格式的 page 参数。■长度限 1024 个字符（含）以内。 3在弹窗中对配置的关联规则进行测试，测试通过后点击 发布二维码 进行发布，通常5分钟后关联规则正式生效。 测试过程中会生成测试二维码（仅作为测试使用），建议确认测试通过后再发布。○精确匹配。 ○模糊匹配。测试过程中需填写测试用 后缀地址 才能生成测试二维码（后缀地址填写举例：“/1”），也可由商家运营人员联系商家开发者进行调试并发布。 说明：当商家需要配置50个（含）以内的关联规则时可参考以上内容，当商家需要配置50个以上的关联规则时，需通过系统对接方式实现，由商家开发者调用api接口关联。目前支付宝对于模板小程序开放调用api接口的系统化关联能力（对非“模板小程序”暂不开放），支持匹配规则的关联和删除（暂不支持修改），接口文档可查看 。该接口同样适用于配置50个（含）以内的关联规则。码规则修改已配置生成的关联规则，支持商家自主修改扫码跳转的小程序页面。修改后，商家无需更改线下已经铺设的普通链接二维码物料，用户扫码时将按照修改后的关联规则跳转至新指定的小程序页面。选择需要修改的关联规则，点击 编辑。说明：匹配规则 的模式和 二维码地址 不支持修改，商家可自主变更 小程序功能页 信息。码规则删除已配置生成的关联规则，支持商家自主删除。删除后关联规则失效，用户无法按照该规则扫码进入小程序，之前使用对应普通链接二维码制作的所有物料都无法按照该规则扫码进入小程序。
