Android集成支付----微信支付总结与封装
扫描二维码
随时随地手机看文章
前言
之前做过一次微信支付的集成,但是没有总结。最近一个App又要集成微信支付,又要重新下载demo,重新看开发文档,重新写代码。相信所有的程序员遇到这种事情都会抓狂。观察了一下微信支付并不设计业务逻辑,完全可以封装成一个工具。
集成微信支付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。
Paste_Image.png2.大坑---支付回调页面
先看官方文档,仔细理解下图被框住的文字。第一次做微信支付被这句话坑惨了,搞了两天都TM找不到我到底错在哪里了,现在想起来就生气。所以这句话的正确解读是:在你的包名下一级目录里面,新建一个文件夹名字为wxapi。而不是像下图一样有两个并列的net.sourceforge.simcpux。
Paste_Image.png
当时之所以被坑的惨,也跟包结构显示样式不同有关系。用Android Studio开发时包结构多半是这样的:
Paste_Image.png
对比以上两张图,相信聪明的你一点会发现问题。
微信支付开发步骤
微信SDK集成之后,准备工作也就做好了,接下来就是要写代码了,有木有一点小激动呢。官方文档:https://pay.weixin.qq.com/wiki/doc/api/app/app.php?chapter=9_12&index=2
1.统一下单(服务端做)
为了更加安全,微信推荐统一下单是交给服务端人员来做的,当然也有一下服务端开发人员觉得麻烦,会推到客户端来做,这个时候千万别怂,一定要跟他讲。
2.请求我们自己的接口
在我们自己的APP中点击微信支付按钮后,我们首先要请求一个我们自己服务端的接口,这时服务端需要走统一下单的逻辑,然后将一些参数返回给我们。这里需要注意,严格来说的话,这个接口应该返回如下所有参数:
Paste_Image.png
尤其是这个签名的过程,微信官方强烈建议放在服务端来做。
而事实上,会有一些服务端开发人员为了他们自己方便,返回过来的数据是这样的:
Paste_Image.png
如果这样的话,签名过程就要放在客户端来做喽。
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.处理微信支付的回调
处理微信支付的回调就是在刚刚创建的WXEntryActivity中处理。需要实现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(); } }
到此微信支付也就完成了,是不是很简单呀。
签名问题
前面提到,有时候签名会让客户端来做,那么我们就来看看签名怎么来搞搞吧。
先看看官方的签名规则:
Paste_Image.png
仔细阅读上面的签名规则,应该不难理解。理解不了也没关系,下面就是我写好的代码:
/** * 调起微信APP支付,签名 */ public static String genPackageSign2(Listparams) { 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
微信支付到此也就总结完了,是不是感觉很简单呢,不过一定要注意别掉坑里。
详细代码请参考github:https://github.com/chaohengxing/WXPayUtils.git