Android集成支付----微信支付总结与封装

转载于:https://www.jianshu.com/p/433307f17b4f

前言

之前做过一次微信支付的集成，但是没有总结。最近一个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.png

2.大坑---支付回调页面

先看官方文档，仔细理解下图被框住的文字。第一次做微信支付被这句话坑惨了，搞了两天都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(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
微信支付到此也就总结完了，是不是感觉很简单呢，不过一定要注意别掉坑里。
详细代码请参考github:https://github.com/chaohengxing/WXPayUtils.git