基于微信支付SDK实现Java后端接口使用

深藏阁楼爱情的钟 2022-08-30 15:00 122阅读 0赞

[微信支付—SDK与DEMO下载][SDK_DEMO]

先看`README.md`  
![在这里插入图片描述][643fb450fd0f2fb276b8e2d80cd1b324.png]

## 微信支付 Java SDK ##

--------------------

对[微信支付开发者文档][Link 1]中给出的API进行了封装。

com.github.wxpay.sdk.WXPay类下提供了对应的方法：

<table> 
 <thead> 
  <tr> 
   <th>方法名</th> 
   <th>说明</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>microPay</td> 
   <td>刷卡支付</td> 
  </tr> 
  <tr> 
   <td>unifiedOrder</td> 
   <td>统一下单</td> 
  </tr> 
  <tr> 
   <td>orderQuery</td> 
   <td>查询订单</td> 
  </tr> 
  <tr> 
   <td>reverse</td> 
   <td>撤销订单</td> 
  </tr> 
  <tr> 
   <td>closeOrder</td> 
   <td>关闭订单</td> 
  </tr> 
  <tr> 
   <td>refund</td> 
   <td>申请退款</td> 
  </tr> 
  <tr> 
   <td>refundQuery</td> 
   <td>查询退款</td> 
  </tr> 
  <tr> 
   <td>downloadBill</td> 
   <td>下载对账单</td> 
  </tr> 
  <tr> 
   <td>report</td> 
   <td>交易保障</td> 
  </tr> 
  <tr> 
   <td>shortUrl</td> 
   <td>转换短链接</td> 
  </tr> 
  <tr> 
   <td>authCodeToOpenid</td> 
   <td>授权码查询openid</td> 
  </tr> 
 </tbody> 
</table>

*  注意:
 *  证书文件不能放在web服务器虚拟目录，应放在有访问权限控制的目录中，防止被他人下载
 *  建议将证书文件名改为复杂且不容易猜测的文件名
 *  商户服务器要做好病毒和木马防护工作，不被非法侵入者窃取证书文件
 *  请妥善保管商户支付密钥、公众帐号SECRET，避免密钥泄露
 *  参数为`Map<String, String>`对象，返回类型也是`Map<String, String>`
 *  方法内部会将参数会转换成含有`appid`、`mch_id`、`nonce_str`、`sign\_type`和`sign`的XML
 *  可选HMAC-SHA256算法和MD5算法签名
 *  通过HTTPS请求得到返回数据后会对其做必要的处理（例如验证签名，签名错误则抛出异常）
 *  对于downloadBill，无论是否成功都返回Map，且都含有`return_code`和`return_msg`，若成功，其中`return_code`为`SUCCESS`，另外`data`对应对账单数据

## 示例 ##

配置类MyConfig:

import com.github.wxpay.sdk.WXPayConfig;
    import java.io.*;
    
    public class MyConfig implements WXPayConfig{ 
    
        private byte[] certData;
    
        public MyConfig() throws Exception { 
            String certPath = "/path/to/apiclient_cert.p12";
            File file = new File(certPath);
            InputStream certStream = new FileInputStream(file);
            this.certData = new byte[(int) file.length()];
            certStream.read(this.certData);
            certStream.close();
        }
    
        public String getAppID() { 
            return "wx8888888888888888";
        }
    
        public String getMchID() { 
            return "12888888";
        }
    
        public String getKey() { 
            return "88888888888888888888888888888888";
        }
    
        public InputStream getCertStream() { 
            ByteArrayInputStream certBis = new ByteArrayInputStream(this.certData);
            return certBis;
        }
    
        public int getHttpConnectTimeoutMs() { 
            return 8000;
        }
    
        public int getHttpReadTimeoutMs() { 
            return 10000;
        }
    }

统一下单：

import com.github.wxpay.sdk.WXPay;
    
    import java.util.HashMap;
    import java.util.Map;
    
    public class WXPayExample { 
    
        public static void main(String[] args) throws Exception { 
    
            MyConfig config = new MyConfig();
            WXPay wxpay = new WXPay(config);
    
            Map<String, String> data = new HashMap<String, String>();
            data.put("body", "腾讯充值中心-QQ会员充值");
            data.put("out_trade_no", "2016090910595900000012");
            data.put("device_info", "");
            data.put("fee_type", "CNY");
            data.put("total_fee", "1");
            data.put("spbill_create_ip", "123.12.12.123");
            data.put("notify_url", "http://www.example.com/wxpay/notify");
            data.put("trade_type", "NATIVE");  // 此处指定为扫码支付
            data.put("product_id", "12");
    
            try { 
                Map<String, String> resp = wxpay.unifiedOrder(data);
                System.out.println(resp);
            } catch (Exception e) { 
                e.printStackTrace();
            }
        }
    
    }

订单查询：

退款查询：

下载对账单：

其他API的使用和上面类似。

暂时不支持下载压缩格式的对账单，但可以使用该SDK生成请求用的XML数据：

import com.github.wxpay.sdk.WXPay;
    import com.github.wxpay.sdk.WXPayUtil;
    
    import java.util.HashMap;
    import java.util.Map;
    
    public class WXPayExample { 
    
        public static void main(String[] args) throws Exception { 
    
            MyConfig config = new MyConfig();
            WXPay wxpay = new WXPay(config);
    
            Map<String, String> data = new HashMap<String, String>();
            data.put("bill_date", "20140603");
            data.put("bill_type", "ALL");
            data.put("tar_type", "GZIP");
    
            try { 
                data = wxpay.fillRequestData(data);
                System.out.println(WXPayUtil.mapToXml(data));
            } catch (Exception e) { 
                e.printStackTrace();
            }
        }
    
    }

收到支付结果通知时，需要验证签名，可以这样做：

import com.github.wxpay.sdk.WXPay;
    import com.github.wxpay.sdk.WXPayUtil;
    
    import java.util.Map;
    
    public class WXPayExample { 
    
        public static void main(String[] args) throws Exception { 
    
            String notifyData = "...."; // 支付结果通知的xml格式数据
    
            MyConfig config = new MyConfig();
            WXPay wxpay = new WXPay(config);
    
            Map<String, String> notifyMap = WXPayUtil.xmlToMap(notifyData);  // 转换成map
    
            if (wxpay.isPayResultNotifySignatureValid(notifyMap)) { 
                // 签名正确
                // 进行处理。
                // 注意特殊情况：订单已经退款，但收到了支付结果成功的通知，不应把商户侧订单状态从退款改成支付成功
            }
            else { 
                // 签名错误，如果数据里没有sign字段，也认为是签名错误
            }
        }
    
    }

HTTPS请求可选HMAC-SHA256算法和MD5算法签名：

import com.github.wxpay.sdk.WXPay;
    import com.github.wxpay.sdk.WXPayConstants;
    
    public class WXPayExample {
    
        public static void main(String[] args) throws Exception {
            MyConfig config = new MyConfig();
            WXPay wxpay = new WXPay(config, WXPayConstants.SignType.HMACSHA256);
            // ......
        }
    }

若需要使用sandbox环境：

[SDK_DEMO]: https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=11_1
[643fb450fd0f2fb276b8e2d80cd1b324.png]: /images/20220829/fb2fc5c0fb3744e682606c243c0fdacf.png
[Link 1]: https://pay.weixin.qq.com/wiki/doc/api/index.html