当前位置: 产品API > 云闪付 > 云闪付APP开放平台-内容接入
产品介绍
  • 服务对象
    特色业务接入方,银联总公司各部门及各分公司等内容提供方。
  • 产品详情

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

  • 应用场景

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

应答码参照
应答码列表
  • 应答码 描述 解决方案
    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非法
接入流程

编号

阶段

责任方

说明

1

合作洽谈

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

内容提供方

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

联系人:虢策

联系电话:021-20632556

2

技术对接

接入申请方

内容提供方

云闪付事业部

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

3

协议签署

接入申请方

内容提供方

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

4

业务上线

接入申请方

内容提供方

云闪付事业部

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

联系人:虢策

联系电话:021-20632556

 

UPSDK插件

一、开放接口列表:

‘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获取是否正确,签名串是否字典排序)


常见问题
  • 云闪付支付包括前台支付和后台支付,如何区分使用?具体支付流程如何?


    a) 后台支付的使用场景是商户后台向云闪付后台发起的一笔扣款请求,根据用户openId确定付款人账号,小额免密, 商户侧需做好安全风险控制。

    b) 前台支付的使用场景是商户后台向云闪付后台发起的一笔扣款请求,但在支付环节需要用户输入云闪付登录密码,短信验证码等要素,适用于大小额支付全场景。

    c) 对接流程如下:

         i) 首先商户必须通过银联合作的收单机构申请支付商户号,如已经申请请忽略此步。

        ii) 新商户按照银联在线的对接步骤,确保在银联在线生产环境上能够支付成功。 

       iii) 银联云闪付支付支持Apply Pay的操作流程 如下:

         1) 如果您还没有开通Apply Pay,请向收单服务方申请开通Apply Pay, 其商户号与银联在线的商户号为同一个。已经开通了Apply Pay的商户请忽略此步。

         2) 登录苹果开发者网站,请将您申请到的商户号名称(比如merchant.com.unionpay.wallet.coupon)和与之相绑定的p12文件(从苹果开发者网站获取)一起发给云闪付产品经理, 开发将会此p12证书绑定到后续云闪付发布版本中,待新版AppStore发布后方可生效。


  • SHA256签名算法如何实现?


    将所有待签名参数按照字段名的ASCII 码从小到大排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串string1。 Key, value均采用原始值,大小写不变,不进行URL 转义。  最后对拼接字符串string1作sha256运算出signature。

    signature=sha256(string1)

    以upsdk签名为例;

    ? appId=a5949221470c4059b9b0b45a90c81527

    ? nonceStr=Wm3WZYTPz0wzccnW

    ? timestamp=1414587457

    ? url=http://mobile.xxx.com?params=value【注意参见FAQ第四点】

    ?frontToken=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg

    步骤1. 对所有待签名参数按照字段名的ASCII 码从小到大排序(字典序)后,使用URL键值对的格式(即key1=value1&key2=value2…)拼接成字符串string1:

    appId=a5949221470c4059b9b0b45a90c81527&frontToken=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&nonceStr=Wm3WZYTPz0wzccnW&

    timestamp=1414587457&url=http://mobile.xxx.com?params=value

    步骤2. 对string1进行sha256签名,得到signature:

    a4bb34a2b60aa34ec4f03754547ca3e39a80e628b9760323d10561997935bb42

    签名用的nonceStr和timestamp必须与请求参数中的nonceStr和timestamp相同。


  • 云闪付开放平台后台请求报文格式如何定义?


    所有后台请求均为POST,JSON报文格式,应答报文JSON格式如下:

    resp: ‘00’表示成功,其他的都表示错误。msg:  成功或者失败详细描述信息。

    params: 具体数据返回,JSON格式。

API接口
获取backendToken
接口描述
基础服务令牌, backendToken为OAUTH2联合登录用
请求方式
POST
生产地址
https://open.95516.com/open/access/1.0/backendToken
测试地址
https://open.95516.com/open/access/1.0/backendToken
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
签名值 signature string 50 M-必填
生成签名的时间戳 timestamp string 50 M-必填
生成签名随机字符串 nonceStr string 50 M-必填
接入方密钥 secret string 32 M-必填
接入方唯一标识 appId string 32 M-必填
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
凭证超时时间 expiresIn string 20 R-原值返回
后台接口调用凭证 backendToken string 20 R-原值返回
示例代码
请求代码

待补充

待补充

获取frontToken
接口描述
基础服务令牌, frontToken为获取前台插件使用
请求方式
POST
生产地址
https://open.95516.com/open/access/1.0/frontToken
测试地址
https://open.95516.com/open/access/1.0/frontToken
请求报文体参数
名称 标识 字段类型 长度 请求要求 默认值 备注
签名值 signature string M-必填 签名值,签名因子包括(appId, secret, nonceStr, timestamp)
生成签名的时间戳 timestamp string M-必填 生成签名的时间戳
生成签名随机字符串 nonceStr string M-必填 生成签名的随机串
接入方密钥 secret string M-必填 接入方密钥
接入方唯一标识 appId string M-必填 接入方的唯一标识
同步应答参数
名称 标识 字段类型 长度 请求要求 默认值 备注
凭证超时时间 expiresIn string R-原值返回 frontToken接口调用凭证超时时间,单位(秒)
前台接口调用凭证 frontToken string R-原值返回 前台插件UPSDK调用,作为签名因子
示例代码
请求代码

待补充

联系我们

业务咨询: 虢策

021-20632556

guoce@unionpay.com

中国银联版权所有©2002-2019沪 ICP备07032180号