付款方 APP 访问收单机构 H5 页面,收单判断当前是否有 该 APP 的用户信息。如没有, 则返回 302 重定向地址, 具体格式如下: “https://qr.95516.com/qrcGtwWeb-web/api/userAuth?version=1.0.0&redirectUrl=收单机构接收处理结果的地址”(具体格式可参考《中国银联二维码交易处理系统技术指南 V2.5》中3.1.6“获取用户授权”接口部分),其中请求的 redirectUrl 值需进行 URLEncode。付款方 APP 将处理用户信 息获取请求,完成后直接访问请求中的 redirectUrl , 并在 redirectUrl 后面添加 userAuthCode和 respCode 两个参数,respCode=00 标识成功,userAuthCode 为后台获取 APP 用户信息的临 时授权码。
获取用户授权接口有以下三种返回情况:1)获取用户信息成功(respCode == 00),收单在订单推送接口必须上送 userId;2)获取用户信息失败(respCode != 00&& respCode != 34), 收单机构需告知用户终止交易;3)付款方不支持获取用户信息(respCode == 34),收单在订 单推送接口可以不送 userId,也不用再执行第二步“获取用户标识”。
本接口为同步应答模式,通过URL回调形式应答页面
名称 | 标识 | AC | APP | 备注 |
---|---|---|---|---|
版本号 | version | 1.0.0 | M | |
重定向地址 | redirectUrl | M | 需要URLEncode | |
授权码 | userAuthCode | C | 获取APP用户信息临时授权码,建议5分钟有效,并且只能访问一次 | |
应答码 | respCode | M |
00-成功 34-不支持获取用户信息 其他-失败 |