微信企业红包api接入

　　项目描述：基于微信浏览器的H5页面，接入微信支付接口和微信红包接口

一、接入前准备条件

1.微信公众号

　　需要基于已认证的微信公众号承载该H5页面。该条件默认已具备，本文重点为红包接口。

2.微信支付商户平台

2.1官方api文档，发放前准备事项，详细阅读！

https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_3&index=2

2.2重点内容解读

　　1、在满足开通红包权限的前提条件下，在开通该权限时，微信支付平台需要操作人下载对应安全控件及证书，保证操作环境安全性！

　　2、充值微信支付账号，大概意思是将银行中的钱预存到平台作为红包金池，已发放的红包金额将从该池中扣减。操作步骤见api文档。

　　3、openid是微信用户在该公众号下的唯一标识，与微信号1对1映射，微信出于用户隐私考虑，使用虚拟id去关联微信用户，所以无法获取微信号。有这方面想法的同学趁早放弃...所以我们支付或发送红包使用openid即可。

　　4、本文使用红包接口调用的方式实现红包发放功能，api文档中第五条相关参数设置可以略过！

二、红包api接入

1.官方api文档，发放普通红包

https://pay.weixin.qq.com/wiki/doc/api/tools/cash_coupon.php?chapter=13_4&index=3

2.重点内容解读

2.1证书问题

　　根据证书使用说明.txt中的描述，JAVA后端为例，使用的证书是.p12格式

　　

　　windows上可以直接双击导入系统，导入过程中会提示输入证书密码，证书密码默认为您的商户ID（如：10010000），在发送POST请求时一定要携带该证书的信息在请求中，具体见代码：

/**
     *  url 请求url       
        xmlParam 请求参数       
        keyStorePath  本地证书路径
     */
    public static Map getMwebUrl(String url, String xmlParam, String keyStorePath) {
         StringBuffer message = new StringBuffer();
         String jsonStr = null;
          Map map = new HashMap();   
         try {
                //商户id，证书的默认密码
                String mchId = PropertyUtil.MERID;
                KeyStore keyStore  = KeyStore.getInstance("PKCS12");
               //本地证书
                FileInputStream instream = new FileInputStream(new File(keyStorePath));
                keyStore.load(instream, mchId.toCharArray());
                SSLContext sslcontext = SSLContexts.custom().loadKeyMaterial(keyStore, mchId.toCharArray()).build();
                SSLConnectionSocketFactory sslsf = new SSLConnectionSocketFactory(sslcontext, new String[] { "TLSv1" }, null, SSLConnectionSocketFactory.BROWSER_COMPATIBLE_HOSTNAME_VERIFIER);
                CloseableHttpClient httpclient = HttpClients.custom().setSSLSocketFactory(sslsf).build();
                //注意这里是post
                HttpPost httpost = new HttpPost(url);
                httpost.setEntity(new StringEntity(xmlParam, "UTF-8"));
                System.out.println("executing request" + httpost.getRequestLine());
                CloseableHttpResponse response = httpclient.execute(httpost);
               
                try {
                    HttpEntity entity = response.getEntity();
                    System.out.println(response.getStatusLine());
                    if (entity != null) {
                        System.out.println("Response content length: " + entity.getContentLength());
                        BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(entity.getContent(),"UTF-8"));
                        //以下为返回参数的处理，根据需求自行修改
                        String text;
                        while ((text = bufferedReader.readLine()) != null) {
                            message.append(text);
                        }
                        jsonStr = message.toString();
                        map = XMLUtils.parseXmlToList(jsonStr);
                    }
                    EntityUtils.consume(entity);
                } catch (IOException e) {
                    e.printStackTrace();
                } finally {
                    response.close();
                }
            } catch (Exception e1) {
                e1.printStackTrace();
            } 
            return map;
    }

2.2请求参数问题

　　2019年8月该api请求必填参数为12个，详见api文档，这里只有签名sign字段需要说明，其余字段非常直观！

签名

详见签名生成算法，以下为sign参数生成代码，仅供参考

/**
    parameters 将所有非空参数装载进SortedMap
*/
public static String createSign(SortedMap<String,Object> parameters){
        StringBuffer sb = new StringBuffer();
        //所有参与传参的参数按照accsii排序（升序）
        Set es = parameters.entrySet();
        Iterator it = es.iterator();
        while(it.hasNext()) {
            Map.Entry entry = (Map.Entry)it.next();
            String k = (String)entry.getKey();
            Object v = entry.getValue();
            //不能包含sign属性及key属性，不需要CDATA模板
            if(null != v && !"".equals(v)
                    && !"sign".equals(k) && !"key".equals(k)) {
                sb.append(k + "=" + v + "&");
            }
        }
        //商户平台设置的密钥key
        //◆ key设置路径：微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->密钥设置
        sb.append("key=" + PropertyUtil.SIGNKEY );
        String sign = "";
        try {
            //MD5加密及中文支持，并转换成全大写
            sign = MD5Utils.getMessageDigest(sb.toString().getBytes("utf-8")).toUpperCase();
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }
        return sign;
    }

　　补充 ：nonce_str参数，随机字符串的生成算法

import java.security.MessageDigest;
public class MD5Utils {
    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;
        }
    }
}

三、总结

　　在接触微信系列的内容之前，接收各种对微信api的吐槽，但是接触了之后发现，他们说的还真对...（甩梗，咳咳）相较阿里的api腾讯的参数描述、步骤指引等不够明确，但仍在可接受的范围之内，退一步讲，以前我没得选，现在也没得选！