中国银联_Android端技术接入

2.支付流程说明

通过支付控件进行交易的流程如下图：

流程图说明：

（1）用户在客户端中点击购买商品，客户端发起订单生成请求到商户后台；

（2）商户后台收到订单生成请求后，按照《手机控件支付产品接口规范》组织并推送订单信息至银联后台；

（3）银联后台接收订单信息并检查通过后，生成对应交易流水号（即TN），并回复交易流水号至商户后台（应答要素：交易流水号等）；

（4）商户后台接收到交易流水号，将交易流水号返回给客户端；

（5）客户端通过交易流水号（TN）调用支付控件；

（6）用户在支付控件中输入相关支付信息后，由支付控件向银联后台发起支付请求；

（7）支付成功后，银联后台将支付结果通知给商户后台；

（8）银联将支付结果通知支付控件；

（9）支付控件显示支付结果并将支付结果返回给客户端；

目前各个平台支持的设备情况如下：

Android平台SDK主要适用于Android 2.3及以上版本的终端设备；

3.测试账号

招商银行借记卡：6226090000000048
    手机号：18100000000
    密码：111101
    短信验证码：123456（先点获取验证码之后再输入）
    证件类型：01身份证
    证件号：510265790128303
    姓名：张三

4.Android客户端

涉及到SDK的接口说明、及其接口调用细节，需要读者具有一定Android编程经验。

4.1SDK包说明

商户开发者在获取到银联提供的开发包后请检查SDK文件所在目录upmp_android/sdkProSDK，以下部分提及的文件均在该目录中：

apk目录下包括了支付控件的apk：UPPayPluginExPro.apk

jar目录下包括了商户集成所需要的jar包、so文件（支持arm,armv7,x86，x86_64和arm64-v8a平台）和资源文件。

UPPayAssistEx.jar定义了调用支付控件所需要的接口。

4.2接口说明

1、支付接口

upmp_android/UPPayAssistEx.jar中定义了启动支付控件的接口，接口定义如下：

4.3添加SDK包

1.   拷贝upmp_android/sdkPro/jar/data.bin到工程的assets/目录下；

2.   拷贝upmp_android/sdkPro/jar/xxx/libentryexpro.so和upmp_android/sdkPro/jar/xxx/libuptsmaddon.so到工程的libs/xxx/目录下，其中xxx为 armeabi-v7a、armeabi、arm64-v8a、x86、x86_64之一。

arm64-v8a(x86_64)是针对arm64(x86 64)架构优化的库文件，引入工程后在arm64(x86 64)机型上性能会提升，但是最终生成的程序包将变大。注意： 如果工程中使用了其他的.so库，那么需要所有.so库都有arm64-v8a(x86_64)的版本。

3.   拷贝upmp_android/sdkPro/UPPayAssistEx.jar到工程的libs/目录下；

4.   拷贝upmp_android/sdkPro/jar/UPPayPluginExPro.jar到工程的libs/目录下；

效果图如下：

接着请右键单击工程，选择Build Path中的 Configure Build Path …，选中Libraries这个tab,并通过Add Jars…导入工程libs目录下的或UPPayPluginExPro.jar。如下图：

在工程的AndroidManifest.xml文件中注册支付插件使用的Activity。添加如下：

同时添加，银联支付插件相关权限：

注意：版本编译时的target应选用Open Mobile API，建议level19以上，如下图所示：

4.4调用支付控件

1、支付接口调用

a) 在调用支付控件的代码文件中引入UPPayAssistEx类如：

b)接着可以通过以下方式调用支付控件：

c) 控件回调说明：

支付完成后，获取支付控件支付结果，并添加相应处理逻辑，只需实现调用Activity中的onActivityResult()方法即可，支付成功时会返回商户客户端支付结果和签名信息。

控件返回的结果信息仅作为参考，商户订单是否成功支付应该以商户后台主动到全渠道查询的结果或者收到全渠道支付结果通知为准。

收到控件返回结果后，建议无视结果中的内容和签名信息，直接到自己的后台查状态，如果后台此时未收到全渠道的后台通知，则主动发起查询接口到全渠道查状态。这样可既保证APP中展示的订单状态和后台记录一致，也可及时更新后台记录的订单状态。

如仍希望使用控件返回的信息，验签时建议送到后台去验签；如果需要在APP中验签，则需要自行实现验签公钥更新的机制，否则银联更新密钥后会验签失败。

示例代码如下：

result_data参数说明：

result_data示例如下：

2、检测是否已安装银联Apk接口调用