前言
之前做过一次微信支付的集成,但是没有总结。最近一个App又要集成微信支付,又要重新下载demo,重新看开发文档,重新写代码。相信所有的程序员遇到这种事情都会抓狂。观察了一下微信支付并不设计业务逻辑,完全可以封装成一个工具。
这里我们分三大步走:
一、导入微信SDK
二、写支付逻辑
三、封装
下面开始详解:
一、集成微信支付SDK
在集成第三方的时候,首先是要在自己的项目中集成对应的SDK后才可以开发的。这个毋庸置疑。这里给出微信官方的集成文档,读者可自行查看,我在这里只对关键地方做出说明。
微信官方集成文档:https://open.weixin.qq.com/cgi-bin/showdocument?action=dir_list&t=resource/res_list&verify=1&id=1417751808&token=6e7c5d2622dcc43878e06cd70caaa27a86d3d1d7&lang=zh_CN
1.导入sdk
如下图,微信支付sdk已经可以通过gradle来导入了,所以建议还在坚守eclipse的同学赶紧转入Android studio。
2.大坑---接收微信的请求及返回值
先看官方文档,仔细理解下图被框住的文字。第一次做微信支付被这句话坑惨了,搞了两天都TM找不到我到底错在哪里了,现在想起来就生气。所以这句话的正确解读是:在你的包名下一级目录里面,新建一个文件夹名字为wxapi。而不是像下图一样有两个并列的net.sourceforge.simcpux。
当时之所以被坑的惨,也跟包结构显示样式不同有关系。用Android Studio开发时包结构多半是这样的:
对比以上两张图,相信聪明的你一点会发现问题。
二、微信支付开发步骤
微信SDK集成之后,准备工作也就做好了,接下来就是要写代码了,有木有一点小激动呢。官方文档:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_12&index=2
1.统一下单(服务端做)
为了更加安全,微信推荐统一下单是交给服务端人员来做的,当然也有一下服务端开发人员觉得麻烦,会推到客户端来做,这个时候千万别怂,一定要跟他讲。
2.请求我们自己的接口
在我们自己的APP中点击微信支付按钮后,我们首先要请求一个我们自己服务端的接口,这时服务端需要走统一下单的逻辑,然后将一些参数返回给我们。这里需要注意,严格来说的话,这个接口应该返回如下所有参数:
尤其是这个签名的过程,微信官方强烈建议放在服务端来做。
而事实上,会有一些服务端开发人员为了他们自己方便,返回过来的数据是这样的:
如果这样的话,签名过程就要放在客户端来做喽。
3.调起微信APP进行支付
调起微信APP是需要请求参数的,也就是上一步中说到的那些参数,当你把这些参数都凑够了,那么这一步也就没什么难度了,就是照着模板写了:
private IWXAPI iwxapi; //微信支付api
/**
*调起微信支付的方法
**/
private void toWXPay() {
iwxapi = WXAPIFactory.createWXAPI(this, null); //初始化微信api
iwxapi.registerApp(appid); //注册appid appid可以在开发平台获取
Runnable payRunnable = new Runnable() { //这里注意要放在子线程
@Override
public void run() {
PayReq request = new PayReq(); //调起微信APP的对象
//下面是设置必要的参数,也就是前面说的参数,这几个参数从何而来请看上面说明
request.appId = appid;
request.partnerId = partnerId;
request.prepayId = prepayId;
request.packageValue = "Sign=WXPay";
request.nonceStr = nonceStr;
request.timeStamp = timeStamp;
request.sign = sign;
iwxapi.sendReq(request);//发送调起微信的请求
}
};
Thread payThread = new Thread(payRunnable);
payThread.start();
}
4.处理微信支付的回调
处理微信支付的回调就是在刚刚创建的WXPayEntryActivity中处理。需要实现IWXAPIEventHandler接口,这个接口会要求你实现onResp方法,我们就在这个方法中处理回调。
@Override
public void onResp(BaseResp resp) {
if(resp.getType()==ConstantsAPI.COMMAND_PAY_BY_WX){
if(resp.errCode==0){
Toast.makeText(this, "支付成功", Toast.LENGTH_LONG).show();
}
else {
Toast.makeText(this, "支付失败", Toast.LENGTH_LONG).show();
}
finish();
}
}
到此微信支付也就完成了,是不是很简单呀。
签名问题
前面提到,有时候签名会让客户端来做,那么我们就来看看签名怎么来搞搞吧。
先看看官方的签名规则:
仔细阅读上面的签名规则,应该不难理解。理解不了也没关系,下面就是我写好的代码:
/**
* 调起微信APP支付,签名
*/
public static String genPackageSign2(List<NameValuePair> params) {
StringBuilder sb = new StringBuilder();
for (int i = 0; i < params.size(); i++) { //将参数拼接成键值对样式的字符串
sb.append(params.get(i).getName());
sb.append('=');
sb.append(params.get(i).getValue());
sb.append('&');
}
sb.append("key=");
sb.append(Constants.API_KEY); //拼接key
//进行MD5加密,并转为大写
String packageSign = MD5.getMessageDigest(sb.toString().getBytes()).toUpperCase();
return packageSign; //返回签名
}
/**
* MD5加密算法
*/
public final static String getMessageDigest(byte[] buffer) {
char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
try {
MessageDigest mdTemp = MessageDigest.getInstance("MD5");
mdTemp.update(buffer);
byte[] md = mdTemp.digest();
int j = md.length;
char str[] = new char[j * 2];
int k = 0;
for (int i = 0; i < j; i++) {
byte byte0 = md[i];
str[k++] = hexDigits[byte0 >>> 4 & 0xf];
str[k++] = hexDigits[byte0 & 0xf];
}
return new String(str);
} catch (Exception e) {
return null;
}
三、微信支付的封装
由于微信支付不涉及很多业务逻辑,因此完全可以封装成工具类。这里对微信支付做了封装,并且用了Builder设计模块(类似Dialog的使用)。
封装后的使用案例:
//在服务端签名
findViewById(R.id.btn1).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
//假装请求了服务器 获取到了所有的数据
WXPayUtils.WXPayBuilder builder = new WXPayUtils.WXPayBuilder();
builder.setAppId("123")
.setPartnerId("56465")
.setPrepayId("41515")
.setPackageValue("5153")
.setNonceStr("5645")
.setTimeStamp("56512")
.setSign("54615")
.build().toWXPayNotSign(MainActivity.this,"123");
}
});
//在客户端签名
findViewById(R.id.btn2).setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View view) {
//假装请求了服务端信息,并获取了appid、partnerId、prepayId
WXPayUtils.WXPayBuilder builder = new WXPayUtils.WXPayBuilder();
builder.setAppId("123")
.setPartnerId("213")
.setPrepayId("3213")
.setPackageValue("Sign=WXPay")
.build()
.toWXPayAndSign(MainActivity.this,"123","key");
}
});
经过这样封装后,下次再接入微信支付就简单多了。会少走很多弯路。
微信支付到此也就总结完了,是不是感觉很简单呢,不过一定要注意别掉坑里。
详细代码请参考github:https://github.com/chaohengxing/WXPayUtils.git
另外在开发中遇到问题可以直接私信我,希望可以帮助到大家
分享一个在线测试接口,可能大家用得到
https://wxpay.wxutil.com/pub_v2/app/app_pay.php
以前不知道这个,感谢下面这位兄弟