unionPay

来自于:官方立即使用

pay

概述

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 平台上的白名单。

在 iOS 端,如果当前设备没有安装银联支付的 APP(云闪付),会自动调起内嵌支付控件支付。如果已经安装了银联支付的 APP(云闪付),默认也是调起内嵌支付控件的。如果配置了白名单,就可以在已安装银联支付的 APP(云闪付)的条件下,调起银联 APP 进行支付了。

配置白名单方法如下:

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

详情参考 APICloud 官方文档之-----白名单配置

测试账号

以下是测试用卡号、手机号等信息(此类信息仅供测试使用,不会发生真实交易) 招商银行借记卡: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

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及更高版本