银联网页授权接口
接口名称
openapi.payment.unionpay.auth
请求方式
POST
请求头
application/json; charset=utf-8
请求业务参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
out_front_url | string | 是 | 256 | 授权完跳转地址 |
store_id | int | 是 | 10 | 门店ID |
- 请求示例:
{ "biz_content": "{\"store_id\":4731,\"out_front_url\":\"http://www.baidu.com\"}", "method": "openapi.payment.unionpay.auth", "format": "json", "sign_method": "md5", "sign": "0BD87A8B50A52163359AD3B508EA0CF7", "app_id": "20170601208876300809", "nonce": "201801161516107665806nonce", "version": "1.0" }
成功响应参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
auth_url | string | 是 | 256 | 授权链接 |
响应示例:
{ "result_message": "成功", "data": { "auth_url": "https://sh.51youdian.com/Api/openApiAuth/unionPayAuth?url=xxx&token=xxx&store_id=xxx" }, "result_code": 200 }
[!TIP]
- 1.第三方控制页面跳转到返回的auth_url后,页面会自动跳转回授权接口传过来的url地址,并拼接上up_user_id,第三方接收这个参数用于后续调起支付接口
- 2.每个用户的up_user_id不会发生改变
- 3.回跳链接可带参数,也可以不用带参数
跳转回的url示例
授权地址不带参数:
http://www.wahahawa.com/?up_user_id=xxxxx
授权地址带参数:
http://www.wahahawa.com/?uid=1&up_user_id=xxxxx
授权参数
参数 | 类型 | 是否必填 | 最大长度 | 描述 |
---|---|---|---|---|
up_user_id | string | 是 | 64 | 银联授权用户标识 |