云闪付APP-内容接入
云闪付
收单机构
商户
开发者
发卡机构
云闪付APP开放平台内容接入业务是指:外部合作方提供的各类特色服务(包括但不限于各分公司的当地特色服务、总公司部门拓展的特色行业服务等)接入云闪付APP的业务。外部合作方通过相应接口对接,使其嵌入的H5页面具备联登,支付等功能。
服务对象

特色业务接入方,银联总公司各部门及各分公司等内容提供方。

产品详情

接入方H5页面接入银联云闪付APP,云闪付APP开放平台助力接入方实现云闪付用户联登,获取用户信息,调用云闪付功能插件等服务。

功能示例:

开放示例工具生产二维码.png

请用云闪付APP扫一扫打开查看功能接口。

应用场景

目前适用于银联总公司各部门及各分公司特色业务接入需求。

接入流程

编号

阶段

责任方

说明

1

合作洽谈

接入申请方(银联总公司各部门及各分公司等)

内容提供方


接入申请方自行完成业务合作洽谈工作,与内容提供方建立合作意向。合作意向确定后,接入申请方向云闪付事业部相关人员提出业务接入申请。


联系人:虢策

联系电话:021-20632556

2

技术对接

接入申请方

内容提供方

云闪付事业部

内容提供方根据云闪付APP开放平台商户对接文档进行改造,银联会指派人员进行技术支持与后续的测试。

3

协议签署

接入申请方

内容提供方

内容提供方通过银联总部或者当地分公司进行协议签署。

4

业务上线

接入申请方

内容提供方

云闪付事业部

测试通过后,接入申请方向云闪付事业部相关人员提交正式上线申请材料申请上线,云闪付事业部审核通过后配置上线。

联系人:虢策

联系电话:021-20632556


 详细接入流程图如下:

微信图片_20190520134504.jpg

应答码参照
应答码 描述 解决方案
a01 INVALID_APP_ID 不合法的ApplD 展开详情
暂无
a02 INVALID_APP_SECRET 不合法的AppSecret 展开详情
暂无
a03 INVALID_SCOPE 不合法的scope 展开详情
暂无
a10 INVALID_BACKEND_TOKEN 不合法的backendtoken,或已过期 展开详情

如果backendtoken已过期,请重新获取backendtoken。

a20 INVALID_FRONT_TOKEN 不合法的fronttoken,或已过期 展开详情
暂无
a21 INVALID_DOMAIN_NAME 域名不支持,不在配置的3个安全域名中 展开详情
暂无
a22 TIME_ERROR 签名用时间戳过期 展开详情
暂无
a23 VERIFY_SIGN_ERROR 验证签名不通过 展开详情
暂无
a24 INVALID_IP IP非法 展开详情
暂无
a30 REDIRECT_URL_NOT_SUPPORT 展开详情
授权回调url不支持
a31 INVALID_CODE 展开详情
不合法的投权code,或已过期

一、开放接口列表:


‘pay’,  支付,银联在线支持。

‘addBankCard’,  绑定银行卡

‘setNavigationBarTitle’,  设置标题栏标题

‘setNavigationBarRightButton’,  设置标题栏右边按钮

‘closeWebApp’,  关闭当前WEB窗口

‘showFlashInfo’,  显示toast文言

‘scanQRCode’,  启动云闪付扫码

‘chooseImage’  拍照或从手机相册中选图

‘getLocationCity’  返回用户在首页选取的城市

‘verifyPayPwd’  进入支付密码输入页面, 验证支付密码输入正确与否

‘getLocationGps’ 获取用户当前GPS点,基于高德火星坐标系

‘showSharePopup’  显示分享弹框


二、使用步骤:


1. 引入JS文件

        在需要调用JS接口的页面引入如下JS文件,(仅支持https): 

        https://open.95516.com/s/open/js/upsdk.js


2. 通过config接口注入权限验证配置

        所有需要使用UPSDK的页面必须先注入配置信息,否则将无法调用(同一个url仅需调用一次; 如果跳转的页面无需使用插件,则无需config, 否则需要重新执行config)。

        upsdk.config({

        appId: ‘’, // 必填,接入方的唯一标识 

        timestamp: , // 必填,生成签名的时间戳,从1970年1月1日00:00:00至今的秒数

        nonceStr: ‘’, // 必填,生成签名的随机串

        signature: ‘’,// 必填,生成签名的摘要,采用sha256算法, 详见最后一章FAQ

        debug: true  // 开发阶段可打开此标记,云闪付APP会将调试信息toast出来

        });

        建议接入方在开发联调时,打开debug: true 开关,UPSDK只有在开关打开时才会输出状态信息,帮助开发者定位错误。 请务必在最终生产版本关闭此开关。

 

3. 配置信息验证

        通过ready接口处理成功验证

        upsdk.ready(function(){

           // config信息验证后会执行ready方法         

        });

        通过error接口处理失败验证

        upsdk.error(function(err){

          // config信息验证失败会执行error方法  

        }); 


报错信息

解释

1.授权回调url不支持

检查申请表开放平台配置的域名,跟请求链接中的redirect_url回调地址的域名是否一致。

2.upsdk is not defined

接入方引用upsdk.js,要依赖zepto 或 jquery的。且jquery不能太低,1.4以上,
  建议最新且jquery.js先引入,在引入upsdk.js之前。

3.请求非法

时间戳是否获取正确,服务器是不是东八区北京时间,取秒,上送的时间戳有效期5分钟。

4.支付控件报错:【应答码】提示信息

该错是全渠道接口返回错误,通过open.unionpay.com技术支持中查询应答码信息和解释。

5.请求报文解析错误

请求是否按照文档规范,是否是http json请求。

6.请求token过期

accessToken 有效期 1小时

backendToken frontToken 有效期 2小时

code 有效期 5分钟

7.upsdk.config报错

按照upsdk.error提示信息:

1、检查时间戳

2、检查fronttoken是否在有效期内。2小时内有效

3、上送的url是否在申请表的安全域名内

4、签名,是否按照文档指引签名(url获取是否正确,签名串是否字典排序)

8.不合法APPSECRET

检查签名因子和上送的请求参数secret。

9.appId 不合法

检查请求参数appId和提供的是否一致。

10.不合法的scope

请求的scope跟权限不匹配,咨询业务人员是否权限一致。

11.请求fronttoken接口验签失败

签名算法按照文档指引sha256算法签名,签名串字典排序,url获取按照window.location.href获取。

12.解密失败

按照接入文档FAQ里的解密方法java版Demo参照解密。

13.不合法的code/不合法的openId

Code或者openId若是从前端传到后台,如果中间有+号,会转义成空格,+号可以替换成%2B解决。

14. The server has understood the request,   but refused to implement it.

调用的接口路径有问题,user.mobile 容易误写成user_mobile

请求全渠道接口报错

1. 商户状态不准确

联系签约收单机构查询原因。一般可能是商户号注销了,

三个月无交易的商户默认关闭

2. 接收不到后台通知

建议自检查下给自己post一条消息能否收到

银联全渠道后台通知以标准的HTTP协议的POST方法向商户上送的后台通知URL发送,超时时间为10秒。

3. 全渠道接口支持https://open.unionpay.com/ajweb/help/respCode/respCodeList














































联系我们

业务咨询: 021-20632556

虢策

guoce@unionpay.com

咨询与服务