开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
小程序开发管理
接入指南
api 列表
隐私信息授权
小程序基础信息
小程序开发版本
小程序应用成员
小程序类目
小程序二维码
代创建小程序
小程序域名
插件管理
小程序备案
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
文档更新记录 >
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
商户可不需更换线下二维码,通过该接口完成配置后,用户用支付宝扫描普通二维码时打开小程序并跳转到指定页面,普通二维码关联小程序最多可设置100条规则。

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.open.mini.qrcode.bind
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

route_url|路由规则url必选string[1,128]
【描述】二维码域名,须通过icp备案验证,支持http、https、ftp开头的链接
【示例值】https://www.yoursite.com/
mode|匹配规则必选string[1,16]
【描述】匹配规则,仅支持exact(精确匹配)、fuzzy(模糊匹配)两个值。 精确匹配:根据填写的二维码地址精确匹配,地址完全一致时才能唤起小程序(如:配置二维码地址为https://www.alipay.com/my?id=123,当用户扫这个地址的二维码可唤起小程序)。 模糊匹配:根据填写的二维码地址模糊匹配,只要地址前缀匹配即可唤起小程序(如:配置二维码地址为https://www.alipay.com/my/,当用户扫的二维码地址为https://www.alipay.com/my/id=123,可唤起小程序)。
【枚举值】
根据填写的二维码地址精确匹配,地址完全一致时才能唤起小程序(如:配置二维码地址为https://www.alipay.com/my?id=123,当用户扫这个地址的二维码可唤起小程序): exact
根据填写的二维码地址模糊匹配,只要地址前缀匹配即可唤起小程序(如:配置二维码地址为https://www.alipay.com/my/,当用户扫的二维码地址为https://www.alipay.com/my/id=123,可唤起小程序): fuzzy
【示例值】fuzzy
page_redirection|小程序功能页地址必选string[1,128]
【描述】小程序功能页,配置扫描二维码后打开的小程序功能页面路径
【示例值】pages/index/index
route_pattern|模式可选string[1,256]
【描述】模式,用于描述通用的路由url格式,适用于同一个host下面存在大量路由的场景,主要用于提升路由性能,其中{0}、{1} 代表路径中的变量
【示例值】http://yoursite.com/merchant/{0}/shop/{1}
常见请求示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.qrcode.bind&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
 -f 'app_auth_token=${app_auth_token}' \
 -f 'biz_content={
	"route_url":"https://www.yoursite.com/",
	"mode":"fuzzy",
	"page_redirection":"pages/index/index",
	"route_pattern":"http://yoursite.com/merchant/{0}/shop/{1}"
}' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

route_group|路由规则组必选string(128)
【描述】路由规则组,用于唯一标记一条路由规则
【示例值】78b59c5b6b2946448bc77e17e544b813
响应示例
{
    "alipay_open_mini_qrcode_bind_response": {
        "code": "10000",
        "msg": "success",
        "route_group": "78b59c5b6b2946448bc77e17e544b813"
    },
    "sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。

公共错误码

业务错误码

错误码错误描述凯发app官方网站的解决方案
system_error系统繁忙
服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试
appqrcode_not_tinyapp非小程序类型
该接口当前仅支持小程序业务
app_is_not_exist应用信息不存在
检查appid是否正确
app_is_not_online业务异常应用不处于上线状态
请上线应用
builded_not_by_template代关联的小程序版本不是基于模板构建的
代关联普通二维码的小程序必须是基于模板构建的
host_verify_faild域名校验失败
检查域名是否合法,并且域名已正确校验
invalid_param参数有误,输入参数非法
对照接口文档检查参数是否合法
not_currently_avalialbe业务异常该功能尚未全量开放
联系技术人员,是否有资格使用该功能
online_version_not_exist商户小程序没有线上版本
请上架商户小程序版本
qrcode_host_route_num_limit该host下规则数量已达到上限
该host下规则数量已达到上限,需创建模式再绑定二维码
qrcode_route_pattern_not_exist模式不存在
联系凯发app官方网站的技术支持人员,检查该模式是否存在
qrcode_route_pattern_not_match业务异常规则和模式不匹配
检查规则和模式参数是否匹配
qrcode_route_pattern_not_permission该模式无法用于绑定该小程序
联系凯发app官方网站的技术支持人员,检查是否有权限使用该模式
qrcode_route_url_invalid业务异常二维码路由url非法
按照文档检查参数的格式
route_create_need_version请先发布代码后再配置二维码规则
确保小程序已经创建过版本
route_over_limit二维码模板已经超过个数限制
删除之前已绑定的无用二维码
route_rule_conflict码路由规则冲突
更换url,确保未被绑定
route_rule_conflict_other业务异常匹配模式已被其他小程序占用
更换规则
secutiy_ssrf_url_faild网址访问失败
请确保route_url字段对应的网址能被访问
secutiy_ssrf_url_illegal网址非法
请确保route_url字段有效
template_mismatch_isvappid模板和三方应用关系不匹配
请重新上架基于模板构建的小程序版本, 该模板必须是自己三方应用下持有的模板
template_not_have_host非模板名下持有域名
请到开放平台配置小程序模板普通二维码路由规则(域名必须相同)
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。
网站地图