银联行业码获取用户标识
1、修订记录
| 修订 | 日期 | 说明 | 作者 |
|---|---|---|---|
| V0.1 | 2018/10/10 | 新接口参数定义 | 邓鑫 |
| V0.2 | 2018/10/12 | 新增获取用户标识接口 | 邓鑫 |
| V0.3 | 2018/12/26 | 异步通知新增返回发往渠道流水、支付网关编号和渠道返回流水 | 邓文泉 |
| V0.4 | 2019/05/09 | 新增终端号、终端信息 | 刘进 |
| V0.5 | 2019/07/04 | 请求参数新增指定支付方式。异步通知新增卡类型 | 郭勇 |
| V0.6 | 2019/12/06 | 请求参数version为3.2时，异步通知新增返回支付宝用户Uid、支付宝账户和银联云闪付款方账号 | 黄敏 |
| V0.7 | 2020/01/15 | 公共参数新增前台通知地址return_url,并补充前台跳转同步参数说明 | 宁华雄 |
| V0.8 | 2020/04/10 | 请求参数新增fail_notify_url、allow_repeat_pay参数 | 宁华雄 |
V0.9 | 2021/12/27 | 支持国密 |王晶 |
2.接口说明
2、业务说明
（1）场景说明
1、用户扫码，app内置浏览器访问二维码URL，进入商户产品/服务H5页面；用户选择产品/服务，进行下单； 2、商户收银台推送订单信息至银联，银联调起APP银联支付，完成交易，银联推送收款交易消息至商户收款侧。
（2）接口说明
1、APP访问的二维码URL，需要到银联进行白名单报备
2、前端跳转到https://qr.95516.com/qrcGtwWeb-web/api/userAuth 获取用户授权码
3、根据用户授权码 userAuthCode，获取用户标识，进行下单，
4、下单成功返回支付URL，app访问支付URL 唤起支付界面进行支付
3、请求地址
| 环境 | HTTPS请求地址 |
|---|---|
| 正式环境 | https://qrcode.ysepay.com/gateway.do |
4、请求参数说明
4.1公共请求参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| method | String(128) | Y | 接口名称 固定值 ysepay.online.cupgetmulapp.userid |
| partner_id | String(20) | Y | 在银盛支付开设的服务商商户号，请联系客户经理提供 |
| timestamp | String(19) | Y | 发送请求的时间，格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50 |
| charset | String(10) | Y | 商户网站使用的编码格式，如UTF-8、GBK、GB2312等，默认值 GBK |
| sign_type | String(10) | Y | 报文签名算法，RSA 、SM |
| sign | String(256) | Y | 签名字符串，再用Base64编码 |
| version | String(3) | Y | 接口版本3.0，当前版本3.0 |
| biz_content | String | Y | 业务请求参数的集合，最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递 |
4.2 业务请求参数
参数名biz_content,值为一个json格式对象，下面列表描述json对象的值
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| userAuthCode | String(12,64) | Y | 用户授权码 |
| appUpIdentifier | String(14,64) | Y | 银联支付标识 示例值： UnionPay/1.0ICBCeLife |
5、响应参数说明
银盛支付对商户的请求数据处理完成后，会将处理的结果数据同步回执给商户。
请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
5.1 公共响应参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| sign | String | Y | 签名字符串，Base64编码 |
| ysepay_online_cupgetmulapp_userid_respose | String | Y | 业务响应参数的集合，最大长度不限 |
5.2 业务响应参数
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| code | String | Y | 响应代码 |
| msg | String | Y | 响应代码描述 |
| trade_status | String(30) | Y | 目前所处的状态。SUCCES：获取成功 ；FAILED：获取失败 |
| sub_msg | String(50) | N | 返回信息 |
| userId | String(128) | N | 用户标识 |
6、样例
无
7、特别说明
用户授权
1.用户手持付款APP主扫收款方自定义的“行业多应用码”；
2.收款方向付款APP发起获取用户授权，通过返回重定向方式发起；
3.获取APP用户信息的临时授权码和银联支付标识（“UnionPay/<版本号>
4.获取用户标识 （1）获取用户信息成功 （2）获取用户信息失败
5.统一下单/订单推送接口上送用户标识useid。