Android

目录：

1. 文档说明
2. sdk集成步骤说明
   2.1 导入相关文件到项目中
   2.2 修改manifest
   2.3 添加activity
3. 接口和字段说明
   3.1 报文格式
   3.2 请求有效性验证算法
   3.3 初始化参数
   3.4 请求支付接口
4. Android相关文件下载

1. 文档说明

本文档主要说明支付SDK集成到android app的主要流程及相关接口解释。

2. sdk集成步骤说明

2.1 导入相关文件到项目中

导入hpaysdk-1.0.jar到APP项目中

微信和支付宝支付只需要导入这个hpaysdk-1.0.jar包就可以啦，后面data.bin是银联卡支付用的

将data.bin添加到assets文件夹下面，导入相关的so库文件。

2.2 修改manifest

1. 在商户应用工程AndroidManifest.xml里添加声明：

   <uses-library android:name="org.simalliance.openmobileapi" android:required="false"/>
   <activity
    android:name="com.unionpay.uppay.PayActivity"
    android:configChanges="orientation|keyboardHidden|keyboard"
    android:screenOrientation="portrait">
   </activity>
   <activity
    android:name="com.unionpay.UPPayWapActivity"
    android:configChanges="orientation|keyboardHidden|fontScale"
    android:screenOrientation="portrait"
    android:windowSoftInputMode="adjustResize" >
   </activity>
   <activity
            android:name="com.alipay.sdk.app.H5PayActivity"
            android:configChanges="orientation|keyboardHidden|navigation"
            android:exported="false"
            android:screenOrientation="behind" >
   </activity>
   <activity
            android:name="com.alipay.sdk.auth.AuthActivity"
            android:configChanges="orientation|keyboardHidden|navigation"
            android:exported="false"
            android:screenOrientation="behind" >
   </activity>
   <activity
           android:name=".wxapi.WXPayEntryActivity"
           android:exported="true"
           android:launchMode="singleTop"/>

2. 添加权限声明

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>
   <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
   <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
   <uses-permission android:name="org.simalliance.openmobileapi.SMARTCARD" />
   <uses-permission android:name="android.permission.NFC" />
   <uses-feature android:name="android.hardware.nfc.hce"/>

   2.3 添加activity

   在包名目录下新建wxapi文件夹，在wxapi文件夹下新建activity：WXPayEntryActivity，并实现接口IWXAPIEventHandler。

注：由于微信唤起支付后，跳回商户app，不会有回调数据，因此需要实现该接口来获取本次支付的状态

3. 接口和字段说明

3.1 报文格式

<Data>
    <字段1>234324</字段1>
    <字段2></字段2>
     ..........
<Data>

3.2 请求有效性验证算法

支付系统接口服务和商户系统约定统一的请求指令验证算法。

• 算法原理：将数据域通过Des加密后作为data参数，并将原文通过RSA私钥签名得到结果作为signature参数
• 算法规则：先用密钥将数据解密得到原文，再用RSA公钥匙对原文进行验签。

3.3 初始化参数

创建HPayApi对象：

   HPayApi hPayApi = HPayAPIFactory.createHPayApi(appid,url);

注：接口地址建议维护在服务端，支付时，由服务端传递过来

3.4 请求支付接口

• 功能码：P2003
• 接口请求地址：
  • 正式环境：由平台商务对接人员提供
  • 测试环境：http://onlinetest.bsoftpay.com/gatewayOnline/gateway/portal/frontReq
• 接口说明：app调用该接口发起预支付，可唤起第三方支付客户端，让用户可以完成支付

注：安全性考虑，参数的加签操作最好由服务端来完成

• 请求参数：<Data>

1. 调起支付交易接口：

   hPayApi.doPay(context, sign, data, new HPayResultListener() {});

2. 参数说明：

   context:上下文
   sign：签名(上述报文由服务端组装XML报文，并由RSA签名算法签名而成)
   data：参数(上述报文由服务端组装XML报文，并由DES机密算法加密而成)
   HPayResultListener：结果回调

   注：HPayResultListener只能获取支付宝的回调信息，微信的回调信息需要通过前面配置的activity来主动获取

服务端XML报文格式:

<Data>
    <字段1>234324</字段1>
    <字段2></字段2>
    ..........
<Data>

3. 回调结果编码

4. Android相关文件下载

• android端支付sdk包