JAVA微信扫码支付模式二功能实现以及回调

一、准备工作

首先吐槽一下微信关于支付这块,本身支持的支付模式就好几种,但是官方文档特别零散,连像样的JAVA相关的demo也没几个。本人之前没有搞过微信支付,一开始真是被它搞晕,折腾两天终于调通了,特此写下来,以享后人吧!

关于准备工作,就“微信扫码支付模式二”官方文档地址在这 https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=6_1 可以先看看,实际上需要准备的东西有以下几个:

JAVA微信扫码支付模式二功能实现以及回调

其中APP_ID和APP_SECRET可以在公众平台找着,MCH_ID和API_KEY则在商户平台找到,特别是API_KEY要在商户平台设置好,对于“微信扫码支付模式二”(支付与回调)实际只会用到APP_ID、MCH_ID和API_KEY,其他的都不用。

关于开发环境,我就不罗嗦了,不管你是springMVC、struts2又或者直接serverlet,都差不多,只要你能保证对应的方法能调用起来就行。关于引用第三方的jar包,我这里只用到了一个xml操作的jdom,记住是1.*的版本,不是官网上最新的2.*,两者不兼容。具体是jdom-1.1.3.jar,依赖包jaxen-1.1.6.jar,就这两个包,我没用到有些例子中使用的httpclient,感觉没必要,而且依赖包特别繁杂,当然你是maven当我没说。

二、开发实战

1、首先是接入微信接口,获取微信支付二维码。

 

 
  1. public String weixin_pay() throws Exception {

  2. // 账号信息

  3. String appid = PayConfigUtil.APP_ID; // appid

  4. //String appsecret = PayConfigUtil.APP_SECRET; // appsecret

  5. String mch_id = PayConfigUtil.MCH_ID; // 商业号

  6. String key = PayConfigUtil.API_KEY; // key

  7.  
  8. String currTime = PayCommonUtil.getCurrTime();

  9. String strTime = currTime.substring(8, currTime.length());

  10. String strRandom = PayCommonUtil.buildRandom(4) + "";

  11. String nonce_str = strTime + strRandom;

  12.  
  13. String order_price = 1; // 价格 注意:价格的单位是分

  14. String body = "goodssssss"; // 商品名称

  15. String out_trade_no = "11338"; // 订单号

  16.  
  17. // 获取发起电脑 ip

  18. String spbill_create_ip = PayConfigUtil.CREATE_IP;

  19. // 回调接口

  20. String notify_url = PayConfigUtil.NOTIFY_URL;

  21. String trade_type = "NATIVE";

  22.  
  23. SortedMap<Object,Object> packageParams = new TreeMap<Object,Object>();

  24. packageParams.put("appid", appid);

  25. packageParams.put("mch_id", mch_id);

  26. packageParams.put("nonce_str", nonce_str);

  27. packageParams.put("body", body);

  28. packageParams.put("out_trade_no", out_trade_no);

  29. packageParams.put("total_fee", order_price);

  30. packageParams.put("spbill_create_ip", spbill_create_ip);

  31. packageParams.put("notify_url", notify_url);

  32. packageParams.put("trade_type", trade_type);

  33.  
  34. String sign = PayCommonUtil.createSign("UTF-8", packageParams,key);

  35. packageParams.put("sign", sign);

  36.  
  37. String requestXML = PayCommonUtil.getRequestXml(packageParams);

  38. System.out.println(requestXML);

  39.  
  40. String resXml = HttpUtil.postData(PayConfigUtil.UFDODER_URL, requestXML);

  41.  
  42.  
  43. Map map = XMLUtil.doXMLParse(resXml);

  44. //String return_code = (String) map.get("return_code");

  45. //String prepay_id = (String) map.get("prepay_id");

  46. String urlCode = (String) map.get("code_url");

  47.  
  48. return urlCode;

  49. }

 

如果不出意外的话,这里就从微信服务器获取了一个支付url,形如weixin://wxpay/bizpayurl?pr=pIxXXXX,之后我们就需要把这个url生成一个二维码,然后就可以使用自己手机微信端扫码支付了。关于二维码生成有很多种方法,各位各取所需吧,我这里提供一个google的二维码生成接口:

 

 
  1. public static String QRfromGoogle(String chl) throws Exception {

  2. int widhtHeight = 300;

  3. String EC_level = "L";

  4. int margin = 0;

  5. chl = UrlEncode(chl);

  6. String QRfromGoogle = "http://chart.apis.google.com/chart?chs=" + widhtHeight + "x" + widhtHeight

  7. + "&cht=qr&chld=" + EC_level + "|" + margin + "&chl=" + chl;

  8.  
  9. return QRfromGoogle;

  10. }

 

 
  1. // 特殊字符处理

  2. public static String UrlEncode(String src) throws UnsupportedEncodingException {

  3. return URLEncoder.encode(src, "UTF-8").replace("+", "%20");

  4. }

 

 

上面代码中涉及到几个工具类:PayConfigUtil、PayCommonUtil、HttpUtil和XMLUtil,其中PayConfigUtil放的就是上面提到一些配置及路径,PayCommonUtil涉及到了获取当前事件、产生随机字符串、获取参数签名和拼接xml几个方法,代码如下:

 

 
  1. public class PayCommonUtil {

  2.  
  3. /**

  4. * 是否签名正确,规则是:按参数名称a-z排序,遇到空值的参数不参加签名。

  5. * @return boolean

  6. */

  7. public static boolean isTenpaySign(String characterEncoding, SortedMap<Object, Object> packageParams, String API_KEY) {

  8. StringBuffer sb = new StringBuffer();

  9. Set es = packageParams.entrySet();

  10. Iterator it = es.iterator();

  11. while(it.hasNext()) {

  12. Map.Entry entry = (Map.Entry)it.next();

  13. String k = (String)entry.getKey();

  14. String v = (String)entry.getValue();

  15. if(!"sign".equals(k) && null != v && !"".equals(v)) {

  16. sb.append(k + "=" + v + "&");

  17. }

  18. }

  19.  
  20. sb.append("key=" + API_KEY);

  21.  
  22. //算出摘要

  23. String mysign = MD5Util.MD5Encode(sb.toString(), characterEncoding).toLowerCase();

  24. String tenpaySign = ((String)packageParams.get("sign")).toLowerCase();

  25.  
  26. //System.out.println(tenpaySign + " " + mysign);

  27. return tenpaySign.equals(mysign);

  28. }

  29.  
  30. /**

  31. * @author

  32. * @date 2016-4-22

  33. * @Description:sign签名

  34. * @param characterEncoding

  35. * 编码格式

  36. * @param parameters

  37. * 请求参数

  38. * @return

  39. */

  40. public static String createSign(String characterEncoding, SortedMap<Object, Object> packageParams, String API_KEY) {

  41. StringBuffer sb = new StringBuffer();

  42. Set es = packageParams.entrySet();

  43. Iterator it = es.iterator();

  44. while (it.hasNext()) {

  45. Map.Entry entry = (Map.Entry) it.next();

  46. String k = (String) entry.getKey();

  47. String v = (String) entry.getValue();

  48. if (null != v && !"".equals(v) && !"sign".equals(k) && !"key".equals(k)) {

  49. sb.append(k + "=" + v + "&");

  50. }

  51. }

  52. sb.append("key=" + API_KEY);

  53. String sign = MD5Util.MD5Encode(sb.toString(), characterEncoding).toUpperCase();

  54. return sign;

  55. }

  56.  
  57. /**

  58. * @author

  59. * @date 2016-4-22

  60. * @Description:将请求参数转换为xml格式的string

  61. * @param parameters

  62. * 请求参数

  63. * @return

  64. */

  65. public static String getRequestXml(SortedMap<Object, Object> parameters) {

  66. StringBuffer sb = new StringBuffer();

  67. sb.append("<xml>");

  68. Set es = parameters.entrySet();

  69. Iterator it = es.iterator();

  70. while (it.hasNext()) {

  71. Map.Entry entry = (Map.Entry) it.next();

  72. String k = (String) entry.getKey();

  73. String v = (String) entry.getValue();

  74. if ("attach".equalsIgnoreCase(k) || "body".equalsIgnoreCase(k) || "sign".equalsIgnoreCase(k)) {

  75. sb.append("<" + k + ">" + "<![CDATA[" + v + "]]></" + k + ">");

  76. } else {

  77. sb.append("<" + k + ">" + v + "</" + k + ">");

  78. }

  79. }

  80. sb.append("</xml>");

  81. return sb.toString();

  82. }

  83.  
  84. /**

  85. * 取出一个指定长度大小的随机正整数.

  86. *

  87. * @param length

  88. * int 设定所取出随机数的长度。length小于11

  89. * @return int 返回生成的随机数。

  90. */

  91. public static int buildRandom(int length) {

  92. int num = 1;

  93. double random = Math.random();

  94. if (random < 0.1) {

  95. random = random + 0.1;

  96. }

  97. for (int i = 0; i < length; i++) {

  98. num = num * 10;

  99. }

  100. return (int) ((random * num));

  101. }

  102.  
  103. /**

  104. * 获取当前时间 yyyyMMddHHmmss

  105. *

  106. * @return String

  107. */

  108. public static String getCurrTime() {

  109. Date now = new Date();

  110. SimpleDateFormat outFormat = new SimpleDateFormat("yyyyMMddHHmmss");

  111. String s = outFormat.format(now);

  112. return s;

  113. }

  114.  
  115. }


HttpUtil和XMLUtil如下:

 

 

 
  1. public class HttpUtil {

  2.  
  3. private static final Log logger = Logs.get();

  4. private final static int CONNECT_TIMEOUT = 5000; // in milliseconds

  5. private final static String DEFAULT_ENCODING = "UTF-8";

  6.  
  7. public static String postData(String urlStr, String data){

  8. return postData(urlStr, data, null);

  9. }

  10.  
  11. public static String postData(String urlStr, String data, String contentType){

  12. BufferedReader reader = null;

  13. try {

  14. URL url = new URL(urlStr);

  15. URLConnection conn = url.openConnection();

  16. conn.setDoOutput(true);

  17. conn.setConnectTimeout(CONNECT_TIMEOUT);

  18. conn.setReadTimeout(CONNECT_TIMEOUT);

  19. if(contentType != null)

  20. conn.setRequestProperty("content-type", contentType);

  21. OutputStreamWriter writer = new OutputStreamWriter(conn.getOutputStream(), DEFAULT_ENCODING);

  22. if(data == null)

  23. data = "";

  24. writer.write(data);

  25. writer.flush();

  26. writer.close();

  27.  
  28. reader = new BufferedReader(new InputStreamReader(conn.getInputStream(), DEFAULT_ENCODING));

  29. StringBuilder sb = new StringBuilder();

  30. String line = null;

  31. while ((line = reader.readLine()) != null) {

  32. sb.append(line);

  33. sb.append("\r\n");

  34. }

  35. return sb.toString();

  36. } catch (IOException e) {

  37. logger.error("Error connecting to " + urlStr + ": " + e.getMessage());

  38. } finally {

  39. try {

  40. if (reader != null)

  41. reader.close();

  42. } catch (IOException e) {

  43. }

  44. }

  45. return null;

  46. }

  47. }

 

 
  1. public class XMLUtil {

  2. /**

  3. * 解析xml,返回第一级元素键值对。如果第一级元素有子节点,则此节点的值是子节点的xml数据。

  4. * @param strxml

  5. * @return

  6. * @throws JDOMException

  7. * @throws IOException

  8. */

  9. public static Map doXMLParse(String strxml) throws JDOMException, IOException {

  10. strxml = strxml.replaceFirst("encoding=\".*\"", "encoding=\"UTF-8\"");

  11.  
  12. if(null == strxml || "".equals(strxml)) {

  13. return null;

  14. }

  15.  
  16. Map m = new HashMap();

  17.  
  18. InputStream in = new ByteArrayInputStream(strxml.getBytes("UTF-8"));

  19. SAXBuilder builder = new SAXBuilder();

  20. Document doc = builder.build(in);

  21. Element root = doc.getRootElement();

  22. List list = root.getChildren();

  23. Iterator it = list.iterator();

  24. while(it.hasNext()) {

  25. Element e = (Element) it.next();

  26. String k = e.getName();

  27. String v = "";

  28. List children = e.getChildren();

  29. if(children.isEmpty()) {

  30. v = e.getTextNormalize();

  31. } else {

  32. v = XMLUtil.getChildrenText(children);

  33. }

  34.  
  35. m.put(k, v);

  36. }

  37.  
  38. //关闭流

  39. in.close();

  40.  
  41. return m;

  42. }

  43.  
  44. /**

  45. * 获取子结点的xml

  46. * @param children

  47. * @return String

  48. */

  49. public static String getChildrenText(List children) {

  50. StringBuffer sb = new StringBuffer();

  51. if(!children.isEmpty()) {

  52. Iterator it = children.iterator();

  53. while(it.hasNext()) {

  54. Element e = (Element) it.next();

  55. String name = e.getName();

  56. String value = e.getTextNormalize();

  57. List list = e.getChildren();

  58. sb.append("<" + name + ">");

  59. if(!list.isEmpty()) {

  60. sb.append(XMLUtil.getChildrenText(list));

  61. }

  62. sb.append(value);

  63. sb.append("</" + name + ">");

  64. }

  65. }

  66.  
  67. return sb.toString();

  68. }

  69.  
  70. }


当然还有一个MD5计算工具类

 

 

 
  1. public class MD5Util {

  2.  
  3. private static String byteArrayToHexString(byte b[]) {

  4. StringBuffer resultSb = new StringBuffer();

  5. for (int i = 0; i < b.length; i++)

  6. resultSb.append(byteToHexString(b[i]));

  7.  
  8. return resultSb.toString();

  9. }

  10.  
  11. private static String byteToHexString(byte b) {

  12. int n = b;

  13. if (n < 0)

  14. n += 256;

  15. int d1 = n / 16;

  16. int d2 = n % 16;

  17. return hexDigits[d1] + hexDigits[d2];

  18. }

  19.  
  20. public static String MD5Encode(String origin, String charsetname) {

  21. String resultString = null;

  22. try {

  23. resultString = new String(origin);

  24. MessageDigest md = MessageDigest.getInstance("MD5");

  25. if (charsetname == null || "".equals(charsetname))

  26. resultString = byteArrayToHexString(md.digest(resultString

  27. .getBytes()));

  28. else

  29. resultString = byteArrayToHexString(md.digest(resultString

  30. .getBytes(charsetname)));

  31. } catch (Exception exception) {

  32. }

  33. return resultString;

  34. }

  35.  
  36. private static final String hexDigits[] = { "0", "1", "2", "3", "4", "5",

  37. "6", "7", "8", "9", "a", "b", "c", "d", "e", "f" };

  38.  
  39. }

 

2、支付回调

支付完成后,微信会把相关支付结果和用户信息发送到我们上面指定的那个回调地址,我们需要接收处理,并返回应答。对后台通知交互时,如果微信收到商户的应答不是成功或超时,微信认为通知失败,微信会通过一定的策略定期重新发起通知,尽可能提高通知的成功率,但微信不保证通知最终能成功。 (通知频率为15/15/30/180/1800/1800/1800/1800/3600,单位:秒)

关于支付回调接口,我们首先要对于支付结果通知的内容进行签名验证,然后根据支付结果进行相应的处理流程即可。

 

 
  1. public void weixin_notify(HttpServletRequest request,HttpServletResponse response) throws Exception{

  2.  
  3. //读取参数

  4. InputStream inputStream ;

  5. StringBuffer sb = new StringBuffer();

  6. inputStream = request.getInputStream();

  7. String s ;

  8. BufferedReader in = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));

  9. while ((s = in.readLine()) != null){

  10. sb.append(s);

  11. }

  12. in.close();

  13. inputStream.close();

  14.  
  15. //解析xml成map

  16. Map<String, String> m = new HashMap<String, String>();

  17. m = XMLUtil.doXMLParse(sb.toString());

  18.  
  19. //过滤空 设置 TreeMap

  20. SortedMap<Object,Object> packageParams = new TreeMap<Object,Object>();

  21. Iterator it = m.keySet().iterator();

  22. while (it.hasNext()) {

  23. String parameter = (String) it.next();

  24. String parameterValue = m.get(parameter);

  25.  
  26. String v = "";

  27. if(null != parameterValue) {

  28. v = parameterValue.trim();

  29. }

  30. packageParams.put(parameter, v);

  31. }

  32.  
  33. // 账号信息

  34. String key = PayConfigUtil.API_KEY; // key

  35.  
  36. logger.info(packageParams);

  37. //判断签名是否正确

  38. if(PayCommonUtil.isTenpaySign("UTF-8", packageParams,key)) {

  39. //------------------------------

  40. //处理业务开始

  41. //------------------------------

  42. String resXml = "";

  43. if("SUCCESS".equals((String)packageParams.get("result_code"))){

  44. // 这里是支付成功

  45. //////////执行自己的业务逻辑////////////////

  46. String mch_id = (String)packageParams.get("mch_id");

  47. String openid = (String)packageParams.get("openid");

  48. String is_subscribe = (String)packageParams.get("is_subscribe");

  49. String out_trade_no = (String)packageParams.get("out_trade_no");

  50.  
  51. String total_fee = (String)packageParams.get("total_fee");

  52.  
  53. logger.info("mch_id:"+mch_id);

  54. logger.info("openid:"+openid);

  55. logger.info("is_subscribe:"+is_subscribe);

  56. logger.info("out_trade_no:"+out_trade_no);

  57. logger.info("total_fee:"+total_fee);

  58.  
  59. //////////执行自己的业务逻辑////////////////

  60.  
  61. logger.info("支付成功");

  62. //通知微信.异步确认成功.必写.不然会一直通知后台.八次之后就认为交易失败了.

  63. resXml = "<xml>" + "<return_code><![CDATA[SUCCESS]]></return_code>"

  64. + "<return_msg><![CDATA[OK]]></return_msg>" + "</xml> ";

  65.  
  66. } else {

  67. logger.info("支付失败,错误信息:" + packageParams.get("err_code"));

  68. resXml = "<xml>" + "<return_code><![CDATA[FAIL]]></return_code>"

  69. + "<return_msg><![CDATA[报文为空]]></return_msg>" + "</xml> ";

  70. }

  71. //------------------------------

  72. //处理业务完毕

  73. //------------------------------

  74. BufferedOutputStream out = new BufferedOutputStream(

  75. response.getOutputStream());

  76. out.write(resXml.getBytes());

  77. out.flush();

  78. out.close();

  79. } else{

  80. logger.info("通知签名验证失败");

  81. }

  82.  
  83. }


签名验证算法和签名生成的算法类似,在上面PayCommonUtil工具类中提供。

 

三、后话

感觉微信扫描支付体验效果还是挺好的,唯一缺点就是相关文档零散,官方的demo居然没有java编写的,希望之后微信官方能够逐步完善吧!

JAVA微信扫码支付模式二功能实现以及回调