android支付宝（Alipay）接入介绍
支付宝的官网地址：https://docs.open.alipay.com/204/105296/
1.将alipaySdk-xxxxxxxx.jar包放入商户应用工程的libs目录下，如下图。
或者在app module下的build.gradle下手动添加依赖，如下代码所示：
dependencies {
......
compile files('libs/alipaySdk-20170725.jar')
......
}修改Manifest
在商户应用工程的AndroidManifest.xml文件里面添加声明：
和权限声明：
添加混淆规则
在商户应用工程的proguard-project.txt里添加以下相关规则：
-keep class com.alipay.android.app.IAlixPay{*;}
-keep class com.alipay.android.app.IAlixPay$Stub{*;}
-keep class com.alipay.android.app.IRemoteServiceCallback{*;}
-keep class com.alipay.android.app.IRemoteServiceCallback$Stub{*;}
-keep class com.alipay.sdk.app.PayTask{ public *;}
-keep class com.alipay.sdk.app.AuthTask{ public *;}
-keep class com.alipay.sdk.app.H5PayCallback {
;
;
}
-keep class com.alipay.android.phone.mrpc.core.** { *; }
-keep class com.alipay.apmobilesecuritysdk.** { *; }
-keep class com.alipay.mobile.framework.service.annotation.** { *; }
-keep class com.alipay.mobilesecuritysdk.face.** { *; }
-keep class com.alipay.tscenter.biz.rpc.** { *; }
-keep class org.json.alipay.** { *; }
-keep class com.alipay.tscenter.** { *; }
-keep class com.ta.utdid2.** { *;}
-keep class com.ut.device.** { *;}
至此，开发包开发资源导入完成。
支付接口调用
需要在新线程中调用支付接口。（可参考alipay_demo实现）
PayTask对象主要为商户提供订单支付、查询功能，及获取当前开发包版本号。
获取PayTask支付对象调用支付（支付行为需要在独立的非ui线程中执行），代码示例：
需要注意的是orderInfo生成的方法在客户端并不安全，所以我们通过后台接口返回的orderInfo,这样APPID和RSA_PRIVATE_KEY都保存在服务端
final String orderInfo = info; // 订单信息
Runnable payRunnable = new Runnable() {
@Override
public void run() {
PayTask alipay = new PayTask(DemoActivity.this);
String result = alipay.payV2(orderInfo,true);
Message msg = new Message();
msg.what = SDK_PAY_FLAG;
msg.obj = result;
mHandler.sendMessage(msg);
}
};
// 必须异步调用
Thread payThread = new Thread(payRunnable);
payThread.start();
| 参数名称 | 参数说明 |
|---|---|
| String orderInfo | app支付请求参数字符串，主要包含商户的订单信息，key=value形式，以&连接。 |
| boolean isShowPayLoading | 用户在商户app内部点击付款，是否需要一个loading做为在钱包唤起之前的过渡，这个值设置为true，将会在调用pay接口的时候直接唤起一个loading，直到唤起H5支付页面或者唤起外部的钱包付款页面loading才消失。（建议将该值设置为true，优化点击付款到支付唤起支付页面的过渡过程。） |
orderStr示例如下，参数说明见"请求参数说明",orderStr的获取必须来源于服务端：
app_id=2015052600090779&biz_content=%7B%22timeout_express%22%3A%2230m%22%2C%22seller_id%22%3A%22%22%2C%22product_code%22%3A%22QUICK_MSECURITY_PAY%22%2C%22total_amount%22%3A%220.02%22%2C%22subject%22%3A%221%22%2C%22body%22%3A%22%E6%88%91%E6%98%AF%E6%B5%8B%E8%AF%95%E6%95%B0%E6%8D%AE%22%2C%22out_trade_no%22%3A%22314VYGIAGG7ZOYY%22%7D&charset=utf-8&method=alipay.trade.app.pay&sign_type=RSA2×tamp=2016-08-15%2012%3A12%3A15&version=1.0&sign=MsbylYkCzlfYLy9PeRwUUIg9nZPeN9SfXPNavUCroGKR5Kqvx0nEnd3eRmKxJuthNUx4ERCXe552EV9PfwexqW%2B1wbKOdYtDIb4%2B7PL3Pc94RZL0zKaWcaY3tSL89%2FuAVUsQuFqEJdhIukuKygrXucvejOUgTCfoUdwTi7z%2BZzQ%3D
返回值： 本方法调用的返回结果，参数说明见"客户端同步返回参数说明"。
支付结果获取和处理
调用pay方法支付后，将通过2种途径获得支付结果：
同步返回
商户应用客户端通过当前调用支付的Activity的Handler对象，通过它的回调函数获取支付结果。（可参考alipay_demo实现）
代码示例：
private Handler mHandler = new Handler() {
public void handleMessage(Message msg) {
Result result = new Result((String) msg.obj);
Toast.makeText(DemoActivity.this, result.getResult(),
Toast.LENGTH_LONG).show();
};
};
异步通知
商户需要提供一个http协议的接口，包含在请求支付的入参中，其key对应notify_url。支付宝服务器在支付完成后，会以POST方式调用notify_url传输数据。
获取当前开发包版本号
调用PayTask对象的getVersion()方法查询。
代码示例：
PayTask payTask = new PayTask(activity);
String version = payTask.getVersion();