unionPay

pay getSEPayinfo checkWalletInstalled

概述

unionPay封装了银联支付的SDK，使用此原生插件可在应用内接入银联支付。接入流程参考银联支付接入文档

银联支付流程如下：

（1）用户在客户端中点击购买商品，客户端发起订单生成请求到商户后台；
（2）商户后台收到订单生成请求后，按照《手机控件支付产品接口规范》（文档见银联帮助中心->下载->开发包->手机控件支付参评技术开发包）组织并推送订单信息至银联后台；
（3）银联后台接收订单信息并检查通过后，生成对应交易流水号（即TN），并回复交易流水号至商户后台（应答要素：交易流水号等）；
（4）商户后台接收到交易流水号，将交易流水号返回给客户端；
（5）客户端通过交易流水号（TN）调用支付控件；
（6）用户在支付控件中输入相关支付信息后，由支付控件向银联后台发起支付请求；
（7）支付成功后，银联后台将支付结果通知给商户后台；
（8）银联将支付结果通知支付控件；
（9）支付控件显示支付结果并将支付结果返回给客户端；

注: 本原生插件实现了上述流程的（5）---（9）步骤

配置 config.xml 文件：

使用此原生插件前需先配置 config.xml文件，方法如下：

- 名称：unionPay
- 参数：urlScheme
- 配置示例:
    
    ```js
    <feature name="unionPay">
        <param name="urlScheme" value="unionPayA000000011" />
    </feature>
    ```
    
- 字段描述：
    
    **urlScheme**：（必须配置）用于实现应用间跳转及数据交换，本应用可以启动银联支付控件，也可以从银联支付控件跳回本应用（***此时需要云编译或自定义loader才能测试本功能***）。urlScheme 的 value 值由字符串 ‘unionPay’ 和本应用的 widgetId 拼接而成，如：unionPayA000000011

【ios平台使用原生插件的配置】

1，配置 plist 文件

在 iOS 9 下直接进行 HTTP 请求时会收到错误提示。不能直接使用 HTTP 进行请求，需要在 Info.plist 新增一段用于控制 ATS 的配置:

<key>NSAppTransportSecurity</key> <dict> 
<key>NSAllowsArbitraryLoads</key> <true/>
</dict>

2， iOS 平台上必须添加白名单，如下：

 <preference name="querySchemes" value="uppaysdk,uppaywallet,uppayx1,uppayx2,uppayx3" />

详情参考 Yonbuilder 移动开发平台官方文档之-----白名单配置

##测试账号

以下是测试用卡号、手机号等信息（此类信息仅供测试使用，不会发生真实交易） 招商银行借记卡：6226090000000048 手机号：18100000000 密码：111101 短信验证码：123456（先点获取验证码之后再输入） 证件类型：01身份证 证件号：510265790128303 姓名：张三 华夏银行贷记卡：6226388000000095 手机号：18100000000 CVN2：248 有效期：1219 短信验证码：123456（先点获取验证码之后再输入） 证件类型：01身份证 证件号：510265790128303 姓名：张三

pay

按交易流水号支付订单

pay({params}, callback(ret, err))

params

tn：

  • 类型：字符串
  • 描述：交易流水号信息，银联后台生成，通过商户后台返回到客户端

devMode：

  • 类型：布尔
  • 描述：接入模式设定，值为 false 代表接入生成环境
  • 默认值：true

seType：

  • 类型：字符串类型
  • 描述：（可选项）手机pay支付类别（仅android支持）
  • 默认：普通银联支付

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    result: "success"     //字符串类型；支付结果信息
                          //取值范围：
                          //success（支付成功）
                          //fail（支付失败）
                          //cancel（用户取消支付）
}

示例代码

    var unPay = api.require('unionPay');
    api.ajax({
        url: 'http://101.231.204.84:8091/sim/getacptn',//从银联测试服务器上获取tn号
        method: 'post',
        dataType: 'text',
        returnAll:false,
    },function(ret,err){
        if (ret) {
            unPay.pay({
                tn: ret,
                devMode: true
            }, function(ret, err){
               api.alert({msg:JSON.stringify(ret)});
            });
        }
    });

可用性

iOS系统 Android系统

可提供的1.0.0及更高版本

** getSEPayinfo**

获取手机pay支持情况

getSEPayinfo({params}, callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
status:,                 //布尔类型；可正常支持手机支付
seName:'',            //字符串类型；手机pay名称，	
seType:'',               //字符串类型；手机pay名称对应类别，与SEName对应关系  seType/seName，‘02’/‘Samsung Pay’、‘04’/‘Huawei Pay’、‘27’/‘Meizu Pay’、‘30’/‘Le Pay’、‘25’/‘Mi Pay’、‘29’/‘Oppo Pay’、‘33’/‘vivo Pay’、‘32’/‘Smartisan Pay’
cardNumbers:,     //数字类型；卡数量
}

err：

  • 类型：JSON 对象
  • 描述：ret.status 为false时返回
  • 内部字段：
{
SEName:'',            //字符串类型；手机pay名称，	
seType:'',               //字符串类型；手机pay名称对应类别
errorCode:‘’,     //字符串类型；错误码；‘01’/手机pay未安装或TSM控件版本低，‘02’/未开通手机支付，‘04’/检测未安装TSM控件，‘10’/接口超时
}

示例代码

var unPay = api.require('unionPay');
unPay.getSEPayinfo({
}, function(ret, err){
api.alert({msg:JSON.stringify(ret)});
 });
 );

可用性

Android系统

可提供的1.0.0及更高版本

checkWalletInstalled

检测是否安装云闪付客户端

checkWalletInstalled({params}, callback(ret, err))

callback(ret, err)

ret：

  • 类型：JSON 对象
  • 内部字段：
{
    status:,         //布尔类型；是否安装了闪付客户端
}

示例代码

var unPay = api.require('unionPay');
unPay. checkWalletInstalled({
}, function(ret, err){
alert({msg:JSON.stringify(ret)});
 });
 );

可用性

Android系统

可提供的1.0.0及更高版本

是否仍需要帮助？ 请保持联络！
最后更新于 2024/12/2