微信：微信扫码支付、调用统一下单接口、网站支付 + springmvc

Myth丶恋晨 2022-06-08 10:14 307阅读 0赞

## 一、场景：公司需要在网站上进行微信支付。 ##

## 二、API：使用微信开放平台的接入微信支付 ##

##     ##

\-扫码支付。 [微信支付开发者平台链接][Link 1]

## 三、分析： ##

1.  接入扫码支付（包含PC网站支付）包含三个阶段，问这里只讲使用，也就是第2阶段的《启动设计和开发》。![Center][]
2.  点击查看开发者文档（扫码支付）后，这里感觉微信的文档没有支付宝好理解（稍微吐槽下~~~），不过我们忽略一切，直接进入模式二：模式二最简单直接，不需要在商户后台进行配置，推荐大家使用，微信也说流程更为简单，我这里也讲的是模式二，模式一大家有兴趣可以自行研究下。![Center 1][]
3.  如上图，总流程有14步，主要流程是生成订单、调统一下单API、将返回的支付交易链接生成二维码展示；我这边主要就是将这三步结合springmvc后，成功生儿二维码之后，用户就可以扫码支付了。后面的回调跟跟我的另一篇博文基本类似，大家借鉴下就行了：[支付宝：web页面扫码支付、网站支付、支付宝即时到账 + springmvc][web_ _ springmvc]

## 四、实现： ##

1. 准备：根据[统一下单接口API][API]我先定义了三个对象：UnifiedOrderRequest（统一下单请求参数(必填)）、UnifiedOrderRequestExt（统一下单请求参数(非必填)）、UnifiedOrderRespose（统一下单返回参数）；具体如下代码，get、set方法可自行生产，太占篇幅。 
 
 UnifiedOrderRequest.class
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 统一下单请求参数(必填) 
 3.  \* @author Y 
 4.  \* 
 5.  \*/  
 6. **public** **class** UnifiedOrderRequest \{  
 7.     **private** String appid;               //公众账号ID  
 8.     **private** String mch\_id;              //商户号  
 9.     **private** String nonce\_str;           //随机字符串  
 10.     **private** String sign;                //签名  
 11.     **private** String body;                //商品描述  
 12.     **private** String out\_trade\_no;        //商户订单号  
 13.     **private** String total\_fee;           //总金额  
 14.     **private** String spbill\_create\_ip;    //终端IP  
 15.     **private** String notify\_url;          //通知地址  
 16.     **private** String trade\_type;          //交易类型  
 17. 
 
 
 UnifiedOrderRequestExt.class
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 统一下单请求参数(非必填) 
 3.  \* @author Y 
 4.  \* 
 5.  \*/  
 6. **public** **class** UnifiedOrderRequestExt **extends** UnifiedOrderRequest\{  
 7.       
 8.     **private** String device\_info;         //设备号  
 9.     **private** String detail;              //商品详情  
 10.     **private** String attach;              //附加数据  
 11.     **private** String fee\_type;            //货币类型  
 12.     **private** String time\_start;          //交易起始时间  
 13.     **private** String time\_expire;         //交易结束时间  
 14.     **private** String goods\_tag;           //商品标记  
 15.     **private** String product\_id;          //商品ID  
 16.     **private** String limit\_pay;           //指定支付方式  
 17.     **private** String openid;              //用户标识  
 18. \}  
 
 UnifiedOrderRespose.class
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 统一下单返回参数 
 3.  \* @author Y 
 4.  \* 
 5.  \*/  
 6. **public** **class** UnifiedOrderRespose \{  
 7.     **private** String return\_code;             //返回状态码  
 8.     **private** String return\_msg;              //返回信息  
 9.     **private** String appid;                   //公众账号ID  
 10.     **private** String mch\_id;                  //商户号  
 11.     **private** String device\_info;             //设备号  
 12.     **private** String nonce\_str;               //随机字符串  
 13.     **private** String sign;                    //签名  
 14.     **private** String result\_code;             //业务结果  
 15.     **private** String err\_code;                //错误代码  
 16.     **private** String err\_code\_des;            //错误代码描述  
 17.     **private** String trade\_type;              //交易类型  
 18.     **private** String prepay\_id;               //预支付交易会话标识  
 19.     **private** String code\_url;                //二维码链接  
 20. \}  
2. Controller主入口：
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 创建二维码 
 3.  \*/  
 4. @RequestMapping("createQRCode")  
 5. **public** **void** createQRCode(String orderId, HttpServletResponse response) \{  
 6.       
 7.     //生成订单  
 8.     String orderInfo = createOrderInfo(orderId);  
 9.     //调统一下单API  
 10.     String code\_url = httpOrder(orderInfo);  
 11.     //将返回预支付交易链接（code\_url）生成二维码图片  
 12.     //这里使用的是zxing   <span style="color:\#ff0000;">说明1(见文末)  
 13.     **try** \{  
 14.         **int** width = 200;  
 15.         **int** height = 200;  
 16.         String format = "png";  
 17.         Hashtable hints = **new** Hashtable();  
 18.         hints.put(EncodeHintType.CHARACTER\_SET, "utf-8");  
 19.         BitMatrix bitMatrix = **new** MultiFormatWriter().encode(code\_url, BarcodeFormat.QR\_CODE, width, height, hints);  
 20.         OutputStream out = **null**;  
 21.         out = response.getOutputStream();  
 22.         MatrixToImageWriter.writeToStream(bitMatrix, format, out);  
 23.         out.flush();  
 24.         out.close();  
 25.     \} **catch** (Exception e) \{  
 26.     \}  
 27.   
 28. \}  
 
 
 
3. 生成订单:分两部分：一部分是业务需求的订单信息，就是发起支付前的订单信息，业务系统自行创建存储；另一部分是满足统一下单API要求的订单信息（也是我们这里要讲的）。“xxxxxx”:是你需要自己填写的对应信息：
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 生成订单 
 3.  \* @param orderId 
 4.  \* @return 
 5.  \*/  
 6. **private** String createOrderInfo(String orderId) \{  
 7.     //生成订单对象  
 8.     UnifiedOrderRequest unifiedOrderRequest = **new** UnifiedOrderRequest();  
 9.     unifiedOrderRequest.setAppid("xxxxxxxxxxxxx");//公众账号ID  
 10.     unifiedOrderRequest.setMch\_id("xxxxxxxxx");//商户号  
 11.     unifiedOrderRequest.setNonce\_str(StringUtil.makeUUID());//随机字符串       <span style="color:\#ff0000;">说明2(见文末)  
 12.     unifiedOrderRequest.setBody("xxxxxx");//商品描述  
 13.     unifiedOrderRequest.setOut\_trade\_no(orderId);//商户订单号  
 14.     unifiedOrderRequest.setTotal\_fee("x");  //金额需要扩大100倍:1代表支付时是0.01  
 15.     unifiedOrderRequest.setSpbill\_create\_ip("xxxxxxxxxxxxx");//终端IP  
 16.     unifiedOrderRequest.setNotify\_url("xxxxxxxxxxxxxx");//通知地址  
 17.     unifiedOrderRequest.setTrade\_type("NATIVE");//JSAPI--公众号支付、NATIVE--原生扫码支付、APP--app支付  
 18.     unifiedOrderRequest.setSign(createSign(unifiedOrderRequest));//签名<span style="color:\#ff0000;">说明5(见文末，签名方法一并给出)  
 19.     //将订单对象转为xml格式  
 20.     XStream xStream = **new** XStream(**new** XppDriver(**new** XmlFriendlyNameCoder("\_-", "\_"))); //<span style="color:\#ff0000;">说明3(见文末)  
 21.     xStream.alias("xml", UnifiedOrderRequest.**class**);//根元素名需要是xml  
 22.     **return** xStream.toXML(unifiedOrderRequest);  
 23. \}  
 
 
 
4. 调统一下单API:根据要求将生成订单中返回的xml向微信给定的统一下单URL地址：https://api.mch.weixin.qq.com/pay/unifiedorder，发送请求，成功并获得二维码。
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 调统一下单API 
 3.  \* @param orderInfo 
 4.  \* @return 
 5.  \*/  
 6. **private** String httpOrder(String orderInfo) \{  
 7.     String url = "https://api.mch.weixin.qq.com/pay/unifiedorder";  
 8.     **try** \{  
 9.         HttpURLConnection conn = (HttpURLConnection) **new** URL(url).openConnection();  
 10.         //加入数据    
 11.            conn.setRequestMethod("POST");    
 12.            conn.setDoOutput(**true**);    
 13.                
 14.            BufferedOutputStream buffOutStr = **new** BufferedOutputStream(conn.getOutputStream());    
 15.            buffOutStr.write(orderInfo.getBytes());  
 16.            buffOutStr.flush();    
 17.            buffOutStr.close();    
 18.                
 19.            //获取输入流    
 20.            BufferedReader reader = **new** BufferedReader(**new** InputStreamReader(conn.getInputStream()));    
 21.                
 22.            String line = **null**;    
 23.            StringBuffer sb = **new** StringBuffer();    
 24.            **while**((line = reader.readLine())!= **null**)\{    
 25.                sb.append(line);    
 26.            \}    
 27.              
 28.            XStream xStream = **new** XStream(**new** XppDriver(**new** XmlFriendlyNameCoder("\_-", "\_")));//说明3(见文末)  
 29.            //将请求返回的内容通过xStream转换为UnifiedOrderRespose对象  
 30.            xStream.alias("xml", UnifiedOrderRespose.**class**);  
 31.            UnifiedOrderRespose unifiedOrderRespose = (UnifiedOrderRespose) xStream.fromXML(sb.toString());  
 32.              
 33.            //根据微信文档return\_code 和result\_code都为SUCCESS的时候才会返回code\_url  
 34.            //<span style="color:\#ff0000;">说明4(见文末)  
 35.            **if**(**null**!=unifiedOrderRespose   
 36.                 && "SUCCESS".equals(unifiedOrderRespose.getReturn\_code())   
 37.                 && "SUCCESS".equals(unifiedOrderRespose.getResult\_code()))\{  
 38.             **return** unifiedOrderRespose.getCode\_url();  
 39.            \}**else**\{  
 40.             **return** **null**;  
 41.            \}  
 42.     \} **catch** (Exception e) \{  
 43.         e.printStackTrace();  
 44.     \}  
 45.     **return** **null**;  
 46. \}   [copy][]
 
 
 
5. 将返回的支付交易链接生成二维码展示：没有异常的情况下，在页面中使用<img>标签接收就行。实际使用时，结合前端和业务的需求放置二维码。可以在[扫码支付/案例及规范][Link 2]中找到部分素材和界面规范来设计微信风格的支付页面。
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. <img src="$\{ctx\}/wxPay/createQRCode?orderId=1111" width="174px">  
 
 ![Center 2][] 
 
6. 用户可以通过维系客户端进行扫码支付。支付完成后回调我们notify\_url设置的url，通过成功的回调来更改业务系统中的订单状态或者一些业务需求。这里回调没有写出可以参考[支付宝：web页面扫码支付、网站支付、支付宝即时到账 + springmvc][web_ _ springmvc]中的回调。

## 五、说明： ##

1. 二维码可以查看[zxing实现二维码生成和解析][zxing]；微信这边也提供了二维码的学习，大家有兴趣可以看看：[http://www.thonky.com/qr-code-tutorial/][http_www.thonky.com_qr-code-tutorial] 和[http://coolshell.cn/articles/10590.html][http_coolshell.cn_articles_10590.html] 
 
 
2. 随机字符串：微信对随机字符串的要求是不超过32位。我这边是这样生成的，用时间戳。
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 创建UUID 
 3.  \* @return 
 4.  \*/  
 5. **public** **static** **synchronized** String makeUUID() \{  
 6.     Date date = **new** Date();  
 7.     StringBuffer s = **new** StringBuffer(DateUtil.formatYmdhmsm(date));  
 8.     **return** s.append((**new** Random().nextInt(900) + 100)).toString();  
 9. \}  
 
 
 
 
 
3. 使用Xstream时，由于微信定义的变量名大部分使用了“\_”,但是在Xstream中它是关键字，所以会自动变为“\_\_”，引起报错。详情请看：[XStream异常：对象转为XML时，会把"\_"转成"\_\_";报错：(Lcom/thoughtworks/xstream/io/naming/NameCoder;)V][XStream_XML_Lcom_thoughtworks_xstream_io_naming_NameCoder_V] 
 
 
4. 获取二维码链接时，只有在return\_code 和result\_code都为SUCCESS的时候有返回；这里我就简单的满足时返回，不满足返回null，您写的时候需要结合业务考虑下，是否需要增加判断，从而满足不同的业务场景。[统一下单API][API] 
 
 
5. 签名在上面一直没有详细说明，首先查看微信的[安全规范][Link 3]中签名算法。key值，需要自己填写![Center 3][]
 
 **\[javascript\]**  [view plain][]  [copy][view plain]
 
   [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1] [![在CODE上查看代码片][CODE]][CODE_CODE] [![派生到我的代码片][ico_fork.svg]][ico_fork.svg 1]
 
 1. /\*\* 
 2.  \* 生成签名 
 3.  \*  
 4.  \* @param appid\_value 
 5.  \* @param mch\_id\_value 
 6.  \* @param productId 
 7.  \* @param nonce\_str\_value 
 8.  \* @param trade\_type  
 9.  \* @param notify\_url  
 10.  \* @param spbill\_create\_ip  
 11.  \* @param total\_fee  
 12.  \* @param out\_trade\_no  
 13.  \* @return 
 14.  \*/  
 15. **private** String createSign(UnifiedOrderRequest unifiedOrderRequest) \{  
 16.     //根据规则创建可排序的map集合  
 17.     SortedMap<String, String> packageParams = **new** TreeMap<String, String>();  
 18.     packageParams.put("appid", unifiedOrderRequest.getAppid());  
 19.     packageParams.put("body", unifiedOrderRequest.getBody());  
 20.     packageParams.put("mch\_id", unifiedOrderRequest.getMch\_id());  
 21.     packageParams.put("nonce\_str", unifiedOrderRequest.getNonce\_str());  
 22.     packageParams.put("notify\_url", unifiedOrderRequest.getNotify\_url());  
 23.     packageParams.put("out\_trade\_no", unifiedOrderRequest.getOut\_trade\_no());  
 24.     packageParams.put("spbill\_create\_ip", unifiedOrderRequest.getSpbill\_create\_ip());  
 25.     packageParams.put("trade\_type", unifiedOrderRequest.getTrade\_type());  
 26.     packageParams.put("total\_fee", unifiedOrderRequest.getTotal\_fee());  
 27.   
 28.     StringBuffer sb = **new** StringBuffer();  
 29.     Set es = packageParams.entrySet();//字典序  
 30.     Iterator it = es.iterator();  
 31.     **while** (it.hasNext()) \{  
 32.         Map.Entry entry = (Map.Entry) it.next();  
 33.         String k = (String) entry.getKey();  
 34.         String v = (String) entry.getValue();  
 35.         //为空不参与签名、参数名区分大小写  
 36.         **if** (**null** != v && !"".equals(v) && !"sign".equals(k)  
 37.                 && !"key".equals(k)) \{  
 38.             sb.append(k + "=" + v + "&");  
 39.         \}  
 40.     \}  
 41.     //第二步拼接key，key设置路径：微信商户平台(pay.weixin.qq.com)-->账户设置-->API安全-->密钥设置  
 42.     sb.append("key=" +"xxxxxxxxxxxxxxxxx");  
 43.     String sign = MD5Util.MD5Encode(sb.toString(), "utf-8")  
 44.             .toUpperCase();//MD5加密  
 45.     **return** sign;  
 46. \}

请使用手机"扫一扫"x

[Link 1]: https://pay.weixin.qq.com/
[Center]: /images/20220608/d702004bd28a48f49e74d8ffcd4f2e8e.png
[Center 1]: /images/20220608/e0451c3c808c4f70954984f2e993c163.png
[web_ _ springmvc]: http://blog.csdn.net/u010246789/article/details/51516511
[API]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=9_1
[view plain]: http://blog.csdn.net/u010246789/article/details/51554021#
[CODE]: https://code.csdn.net/assets/CODE_ico.png
[CODE_CODE]: https://code.csdn.net/snippets/1703859
[ico_fork.svg]: https://code.csdn.net/assets/ico_fork.svg
[ico_fork.svg 1]: https://code.csdn.net/snippets/1703859/fork
[copy]: http://blog.csdn.net/u010449283/article/details/52195117#
[Link 2]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_2
[Center 2]: /images/20220608/3e22c0ab3cd14f3797a25d39b03b7fc2.png
[zxing]: http://blog.csdn.net/u010246789/article/details/51554802
[http_www.thonky.com_qr-code-tutorial]: http://www.thonky.com/qr-code-tutorial/
[http_coolshell.cn_articles_10590.html]: http://coolshell.cn/articles/10590.html
[XStream_XML_Lcom_thoughtworks_xstream_io_naming_NameCoder_V]: http://blog.csdn.net/u010246789/article/details/51553808
[Link 3]: https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4_3
[Center 3]: /images/20220608/621dc93c2bc64d159c3e8416d81fe69c.png