Android集成支付宝支付功能

在移动应用开发中,不少应用都有支付的功能需求,在移动支付方面,支付宝支付与微信支付方便快捷,并且用户人群广,是很多移动支付的首选。在之前的“动高服务”App的项目开发中,应用的支付模块就使用了三种支付方式:我的钱包支付、支付宝支付和微信支付。
本篇博客将对支付宝支付的接入开发过程做一个整理与总结。

下一篇:Android集成微信支付功能

一、开发准备

1. 支付宝官方文档-移动支付

2. 移动支付的SDK&DEMO下载

3. 移动支付-接入指南 - 此文档非常重要,后面详细说明。

4. 本教程对应的源代码

二、支付宝接入

想要接入支付宝移动支付功能,必须在支付宝商家服务平台进行申请与审核。移动支付功能需要企业或者个体工商户进行申请,审核通过之后方可使用。

如何与支付宝签约并审核请参考官方文档:移动支付-接入指南,里面详细介绍了产品签约与审核流程。并且详细介绍了申请成功之后如何查看或生成必要的一些配置参数。

个人开发者则可以下载支付宝提供的Demo进行学习研究,在实际项目开发中,将必要参数替换即可。

2.1 开发前配置

1. 导入Alipay Jar包

将下载的Jar包alipaySDK-xxx.jar复制到libs文件夹下,如果libs文件夹不存在则新建一个,然后右键Jar包,选择Add to Build Path即可。

如果开发的时候发现Jar包不起作用,那么则进入该项目的Java Build Path,选中Order and Export,将alipaySDK-xxx.jar勾选即可。

2. 修改Manifest文件

添加相应权限:

1
2
3
4
5
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_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" />

添加支付宝的H5支付页面(当手机没有安装支付宝时调用H5支付页面):

1
2
3
4
5
6
7
8
9
10
<!-- alipay sdk begin -->
<!-- 若手机没有安装支付宝,则调用H5支付页面 -->
<activity
android:name="com.alipay.sdk.app.H5PayActivity"
android:configChanges="orientation|keyboardHidden|navigation|screenSize"
android:exported="false"
android:screenOrientation="behind"
android:windowSoftInputMode="adjustResize|stateHidden" >
</activity>
<!-- alipay sdk end -->

3. 添加混淆规则

在项目的proguard-project.txt里添加以下相关规则:

1
2
3
4
5
6
7
8
-libraryjars libs/alipaySDK-20160223.jar

-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 *;}

注意:第一行中的alipaySDK-20160223.jar,其中20160223是此版本发布的日期,注意将其修改为你导入的Jar的相应的文件名。

至此开发前的配置已完成,接下来就可以进行代码的编写了。

2.2 程序结构

在我的Demo项目中,我将支付宝支付相关的类统一放在了com.pay.alipay包中。

src目录结构如下:

1
2
3
4
5
6
7
8
9
10
src
├── com.pay.activity
| ├── MainActivity.java
├── com.pay.alipay
| ├── AlipayAPI.java
| ├── AlipayConfig.java
| ├── Base64.java
| ├── PayResult.java
| └── SignUtils.java
└── ...
  • MainActivity.java - 主界面
  • AlipayAPI.java - 支付的一些主要方法
  • AlipayConfig.java - 基础配置
  • Base64.java - RSA密钥转换
  • PayResult.java - 支付结果
  • SignUtils.java - RSA签名类

官方Demo中将支付,订单创建等操作都放在了Activity中,为了使代码结构更加清晰,我将支付的实现放在了AlipayAPI中。

2.3 支付接口调用

以我的写的Demo为例,主界面代码如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
public class MainActivity extends Activity implements OnClickListener{

private static final int SDK_PAY_FLAG = 1;

private Button btnAlipay;

private Handler mHandler = new Handler() {
public void handleMessage(Message msg) {
switch (msg.what) {
case SDK_PAY_FLAG: {
PayResult payResult = new PayResult((String) msg.obj);
/**
* 同步返回的结果必须放置到服务端进行验证,建议商户依赖异步通知
*/
String resultInfo = payResult.getResult();// 同步返回需要验证的信息

String resultStatus = payResult.getResultStatus();
// 判断resultStatus 为“9000”则代表支付成功,具体状态码代表含义可参考接口文档
if (TextUtils.equals(resultStatus, "9000")) {
Toast.makeText(MainActivity.this, "支付成功", Toast.LENGTH_SHORT).show();
} else {
// 判断resultStatus 为非"9000"则代表可能支付失败
// "8000"代表支付结果因为支付渠道原因或者系统原因还在等待支付结果确认,最终交易是否成功以服务端异步通知为准(小概率状态)
if (TextUtils.equals(resultStatus, "8000")) {
Toast.makeText(MainActivity.this, "支付结果确认中", Toast.LENGTH_SHORT).show();
} else {
// 其他值就可以判断为支付失败,包括用户主动取消支付,或者系统返回的错误
Toast.makeText(MainActivity.this, "支付失败", Toast.LENGTH_SHORT).show();
}
}
break;
}
}
};
};

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);

initView();
}

private void initView(){
btnAlipay = (Button) findViewById(R.id.btn_alipay);
btnAlipay.setOnClickListener(this);
}
/**
* 支付宝支付异步任务
* @author Kylin
*/
private class AliPayThread extends Thread {
@Override
public void run() {
String result = AlipayAPI.pay(MainActivity.this, "测试的商品", "测试商品的详细描述", "0.01");
Message msg = new Message();
msg.what = SDK_PAY_FLAG;
msg.obj = result;
mHandler.sendMessage(msg);
}
}
@Override
public void onClick(View view) {
switch (view.getId()) {
case R.id.btn_alipay:
// 使用支付宝进行支付
new AliPayThread().start();
break;

default:
break;
}
}
}

当点击了支付按钮之后,创建一个子线程执行支付操作,调用AlipayAPI.pay()方法进行支付,返回result之后通知Handler进行处理,取出resultStatus参数判断支付是否成功。

  • resultStatus = 9000 :支付成功
  • resultStatus = 8000 :支付确认中(小概率事件)
  • resultStatus = 其他 :支付失败

2.4 支付调用过程

上面介绍了支付的调用以及返回结果的获取和判断这一完整的支付流程,下面解释一下支付调用的过程。

首先需要在AlipayConfig.java中配置相应的参数,参数的获取在上面有介绍(由于参数比较敏感,所以此处为空):

1
2
3
4
5
6
7
8
9
10
public class AlipayConfig {
// 商户PID
public static final String PARTNER = "";
// 商户收款账号
public static final String SELLER = "";
// 商户私钥,pkcs8格式
public static final String RSA_PRIVATE = "";
// 支付宝公钥
public static final String RSA_PUBLIC = "";
}

配置好了参数之后才可以使程序正常运行,下面来看AlipayAPI.pay()方法:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
/**
* @param activity
* @param subject 商品名称
* @param body 商品的详细描述
* @param price 支付金额
* @return
*/
public static String pay(Activity activity, String subject, String body, String price) {

String orderInfo = getOrderInfo(subject, body, price); // 创建订单信息
/**
* 特别注意,这里的签名逻辑需要放在服务端,切勿将私钥泄露在代码中!
*/
String sign = sign(orderInfo);
try {
sign = URLEncoder.encode(sign, "UTF-8"); // 仅需对sign 做URL编码
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
/**
* 完整的符合支付宝参数规范的订单信息
*/
final String payInfo = orderInfo + "&sign=\"" + sign + "\"&" + getSignType();

PayTask alipay = new PayTask(activity);
String result = alipay.pay(payInfo, true); // 调用支付接口进行支付

return result;
}

首先需要通过getOrderInfo()方法创建订单信息,其实就是按照支付宝规定的格式封装相应的数据,其中就有AlipayConfig.java中的参数,具体过程请查看源代码。创建完订单信息之后,需要使用sign()方法对其签名,然后使用UTF-8编码对sign进行编码。

PayTask接口是开发包提供支付,查询的对象接口。下面的代码就是支付宝支付的操作代码,result就是支付返回的结果。

1
2
PayTask alipay = new PayTask(activity);
String result = alipay.pay(payInfo, true); // 调用支付接口进行支付

2.5 获取当前开发包版本号

可以通过下面的代码获取支付宝开发包的版本号:

1
2
PayTask payTask = new PayTask(activity);
String version = payTask.getVersion();

三、Demo截图

Android-Alipay-Image

四、注意事项

相信在上面的介绍中都看到了有几处注释说明了,此项操作要放在服务器操作等等之类的。

这是因为代码中有一些参数和操作是比较敏感的,如果被一些不法分子得到之后有可能会对商家造成一定的损失,虽然添加了混淆规则,但是还是将其放在服务器端较为安全。

所以建议在学习了支付宝支付的步骤之后,根据自己的功能需求设计网络通信接口,将支付宝支付中的部分敏感信息及操作放在服务器端进行以保证支付的安全。

本教程对应的源代码已上传到Github,感兴趣的可以下载查看:Android-Alipay-Demo(本项目中涉及到的敏感参数已经置空,请自行替换成自己应用的参数)。

如果觉得我的文章对您有用,请随意打赏。您的支持将鼓励我继续创作!