微信公众号开发之扫码支付

2016-10-15 本文已影响9599人 Javen205

欢迎留言、转发

微信极速开发系列文章：http://www.jianshu.com/p/a172a1b69fdd

上一篇文章介绍了微信提供的那些支付方式以及公众号支付http://www.jianshu.com/p/cb2456a2d7a7

这篇文章我们来聊聊微信扫码支付（模式一以及模式二）

先奉上研究微信扫码支付踩过的坑

微信扫码支付文档

扫码支付官方文档

扫码支付分为以下两种方式：

【模式一】：商户后台系统根据微信支付规则链接生成二维码，链接中带固定参数productid（可定义为产品标识或订单号）。用户扫码后，微信支付系统将productid和用户唯一标识(openid)回调商户后台系统(需要设置支付回调URL)，商户后台系统根据productid生成支付交易，最后微信支付系统发起用户支付流程。

【模式二】：商户后台系统调用微信支付统一下单API生成预付交易，将接口返回的链接生成二维码，用户扫码后输入密码完成支付交易。注意：该模式的预付单有效期为2小时，过期后无法支付。详细接入步

扫码支付模式一

1、设置支付回调URL

商户支付回调URL设置指引：进入公众平台-->微信支付-->开发配置-->扫码支付-->修改如下图（来自官方文档）

扫码支付模式一设置回调URL.png

在开源项目weixin-guide中扫码支付模式一的回调URL为http://域名[/项目名称]/pay/wxpay

2、根据微信支付规则链接生成二维码

2.1 生成二维码规则

二维码中的内容为链接，形式为：

weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXXX&time_stamp=XXXXXX&nonce_str=XXXXX

详细的参数说明参考文档点击这里

商户ID(mch_id)如何获取点击这里

签名安全规则文档点击这里

在开源项目weixin-guide中 扫码支付模式一 生成二维码规则封装如下：

public String getCodeUrl(){
  String url="weixin://wxpay/bizpayurl?sign=XXXXX&appid=XXXXX&mch_id=XXXXX&product_id=XXXXX&time_stamp=XXXXX&nonce_str=XXXXX";
  String product_id="001";
  String timeStamp=Long.toString(System.currentTimeMillis() / 1000);
  String nonceStr=Long.toString(System.currentTimeMillis());
  Map<String, String> packageParams = new HashMap<String, String>();
  packageParams.put("appid", appid);
  packageParams.put("mch_id", partner);
  packageParams.put("product_id",product_id);
  packageParams.put("time_stamp", timeStamp);
  packageParams.put("nonce_str", nonceStr);
  String packageSign = PaymentKit.createSign(packageParams, paternerKey);
  
  return StringUtils.replace(url, "XXXXX", packageSign,appid,partner,product_id,timeStamp,nonceStr);
 }

以上action 在开源项目weixin-guide中访问地址为http://域名[/项目名称]/pay/getCodeUrl 其中 product_id 根据实际的业务逻辑可以当做参数传入

2.2 生成二维码并在页面上显示

根据2.1生成二维码规则生成了二维码中的内容(链接)来生成二维码。

商户可调用第三方库生成二维码图片

这里使用google 开源图形码工具Zxing

项目中引入相关的jar包具体配置参考项目中的pom.xml

<!-- 版本号-->
<zxing.version>3.2.1</zxing.version>

<!-- 开源多维码生成工具 -->
  <dependency>
   <groupId>com.google.zxing</groupId>
   <artifactId>core</artifactId>
   <version>${zxing.version}</version>
  </dependency>
  <dependency>
   <groupId>com.google.zxing</groupId>
   <artifactId>javase</artifactId>
   <version>${zxing.version}</version>
  </dependency>

封装的工具类为com.javen.kit.ZxingKit

/**
 * google 开源图形码工具Zxing使用
 */
public class ZxingKit {
 private static Log log = Log.getLog(ZxingKit.class.getSimpleName());

 /**
  * Zxing图形码生成工具
  *
  * @param contents
  *            内容
  * @param barcodeFormat
  *            BarcodeFormat对象
  * @param format
  *            图片格式，可选[png,jpg,bmp]
  * @param width
  *            宽
  * @param height
  *            高
  * @param margin
  *            边框间距px
  * @param saveImgFilePath
  *            存储图片的完整位置，包含文件名
  * @return
  */
 public static Boolean encode(String contents, BarcodeFormat barcodeFormat, Integer margin,
   ErrorCorrectionLevel errorLevel, String format, int width, int height, String saveImgFilePath) {
  Boolean bool = false;
  BufferedImage bufImg;
  Map<EncodeHintType, Object> hints = new HashMap<EncodeHintType, Object>();
  // 指定纠错等级
  hints.put(EncodeHintType.ERROR_CORRECTION, errorLevel);
  hints.put(EncodeHintType.MARGIN, margin);
  hints.put(EncodeHintType.CHARACTER_SET, "UTF-8");
  try {
   // contents = new String(contents.getBytes("UTF-8"), "ISO-8859-1");
   BitMatrix bitMatrix = new MultiFormatWriter().encode(contents, barcodeFormat, width, height, hints);
   MatrixToImageConfig config = new MatrixToImageConfig(0xFF000001, 0xFFFFFFFF);
   bufImg = MatrixToImageWriter.toBufferedImage(bitMatrix, config);
   bool = writeToFile(bufImg, format, saveImgFilePath);
  } catch (Exception e) {
   e.printStackTrace();
  }
  return bool;
 }

 /**
  * @param srcImgFilePath
  *            要解码的图片地址
  * @return
  */
 @SuppressWarnings("finally")
 public static Result decode(String srcImgFilePath) {
  Result result = null;
  BufferedImage image;
  try {
   File srcFile = new File(srcImgFilePath);
   image = ImageIO.read(srcFile);
   if (null != image) {
    LuminanceSource source = new BufferedImageLuminanceSource(image);
    BinaryBitmap bitmap = new BinaryBitmap(new HybridBinarizer(source));

    Hashtable<DecodeHintType, String> hints = new Hashtable<DecodeHintType, String>();
    hints.put(DecodeHintType.CHARACTER_SET, "UTF-8");
    result = new MultiFormatReader().decode(bitmap, hints);
   } else {
    log.debug("Could not decode image.");
   }
  } catch (Exception e) {
   e.printStackTrace();
  } finally {
   return result;
  }
 }

 /**
  * 将BufferedImage对象写入文件
  *
  * @param bufImg
  *            BufferedImage对象
  * @param format
  *            图片格式，可选[png,jpg,bmp]
  * @param saveImgFilePath
  *            存储图片的完整位置，包含文件名
  * @return
  */
 @SuppressWarnings("finally")
 public static Boolean writeToFile(BufferedImage bufImg, String format, String saveImgFilePath) {
  Boolean bool = false;
  try {
   bool = ImageIO.write(bufImg, format, new File(saveImgFilePath));
  } catch (Exception e) {
   e.printStackTrace();
  } finally {
   return bool;
  }
 }

 public static void main(String[] args) {
  String saveImgFilePath = "D://zxing.png";
  Boolean encode = encode("我是Javen205", BarcodeFormat.QR_CODE, 3, ErrorCorrectionLevel.H, "png", 200, 200,
    saveImgFilePath);
  if (encode) {
   Result result = decode(saveImgFilePath);
   String text = result.getText();
   System.out.println(text);
  }
 }
}

OK 上面就是生成支付二维码的部分，接下来就是要将二维码显示在页面上，于是就有了下面的代码：
com.javen.weixin.controller.WeixinPayController.getPayQRCode()

src\\main\\webapp\\view\\payQRCode.jsp

/**
  * 生成支付二维码（模式一）并在页面上显示
  */
public void scanCode1(){
  //获取扫码支付（模式一）url
  String qrCodeUrl=getCodeUrl();
  System.out.println(qrCodeUrl);
  //生成二维码保存的路径
  String name = "payQRCode.png";
  Boolean encode = ZxingKit.encode(qrCodeUrl, BarcodeFormat.QR_CODE, 3, ErrorCorrectionLevel.H, "png", 200, 200,
    PathKit.getWebRootPath()+File.separator+"view"+File.separator+name );
  if (encode) {
   //在页面上显示
   setAttr("payQRCode", name);
   render("payQRCode.jsp");
  }
 }

JSP 部分代码如下

<body>
<img alt="" src="<%=path %>/view/${payQRCode}">
</body>

最终生成二维码访问地址为http://域名[/项目名称]/pay/scanCode1

以上就是微信扫码支付(模式一)生成支付二维码的全过程

3、扫码回调商户支付URL

用户扫码后，微信支付系统将productid和用户唯一标识(openid)回调商户后台系统。

此回调的URL为上文设置支付回调的URL。特别要注意的是返回参数是xml输入流

HttpServletRequest request = getRequest();
    /**
    * 获取用户扫描二维码后，微信返回的信息
    */
   InputStream inStream = request.getInputStream();
   ByteArrayOutputStream outSteam = new ByteArrayOutputStream();
   byte[] buffer = new byte[1024];
   int len = 0;
   while ((len = inStream.read(buffer)) != -1) {
       outSteam.write(buffer, 0, len);
   }
   outSteam.close();
   inStream.close();
   String result  = new String(outSteam.toByteArray(),"utf-8");
   System.out.println("callBack_xml>>>"+result);

<xml>
<appid><![CDATA[wx5e9360a3f46f64cd]]></appid>
<openid><![CDATA[o_pncsidC-pRRfCP4zj98h6slREw]]></openid>
<mch_id><![CDATA[商户ID]]></mch_id>
<is_subscribe><![CDATA[Y]]></is_subscribe>
<nonce_str><![CDATA[gT5NJAlv9eXawn1j]]></nonce_str>
<product_id><![CDATA[001]]></product_id>
<sign><![CDATA[D2BD7949269271B3112B442421B43D66]]></sign>
</xml>

4、根据回调参数生成预付订单进行支付

根据回调参数调用统一下单API生成预支付交易的prepay_id

prepay_xml>>>
<xml><return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[微信的appid]]></appid>
<mch_id><![CDATA[商户ID]]></mch_id>
<nonce_str><![CDATA[p46NAoD82eAH2d9j]]></nonce_str>
<sign><![CDATA[4117C601F41533DC84159AF6B892F72D]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<prepay_id><![CDATA[wx201610151315007cb1cbe40b0064755332]]></prepay_id>
<trade_type><![CDATA[NATIVE]]></trade_type>
<code_url><![CDATA[weixin://wxpay/bizpayurl?pr=QCLqJIG]]></code_url>
</xml>

商户后台系统将prepay_id返回给微信支付系统,微信支付系统根据交易会话标识，发起用户端授权支付流程。

/**
          * 发送信息给微信服务器
          */
   Map<String, String> payResult = PaymentKit.xmlToMap(xmlResult);
   
   String return_code = payResult.get("return_code");
   String result_code = payResult.get("result_code");
   
   if (StrKit.notBlank(return_code) && StrKit.notBlank(result_code) && return_code.equalsIgnoreCase("SUCCESS")&&result_code.equalsIgnoreCase("SUCCESS")) {
    // 以下字段在return_code 和result_code都为SUCCESS的时候有返回
    String prepay_id = payResult.get("prepay_id");
    
    Map<String, String> prepayParams = new HashMap<String, String>();
    prepayParams.put("return_code", "SUCCESS");
    prepayParams.put("appId", appid);
    prepayParams.put("mch_id", mch_id);
    prepayParams.put("nonceStr", System.currentTimeMillis() + "");
    prepayParams.put("prepay_id", prepay_id);
    String prepaySign = null;
    if (sign.equals(packageSign)) {
     prepayParams.put("result_code", "SUCCESS");
    }else {
     prepayParams.put("result_code", "FAIL");
     prepayParams.put("err_code_des", "订单失效");   //result_code为FAIL时，添加该键值对，value值是微信告诉客户的信息
    }
    prepaySign = PaymentKit.createSign(prepayParams, paternerKey);
    prepayParams.put("sign", prepaySign);
    String xml = PaymentKit.toXml(prepayParams);
    log.error(xml);
    renderText(xml);
    
   }

5、支付结果通用通知

官方文档点击这里

对后台通知交互时，如果微信收到商户的应答不是成功或超时，微信认为通知失败，微信会通过一定的策略定期重新发起通知，尽可能提高通知的成功率，但微信不保证通知最终能成功。（通知频率为15/15/30/180/1800/1800/1800/1800/3600，单位：秒）
注意：同样的通知可能会多次发送给商户系统。商户系统必须能够正确处理重复的通知。
推荐的做法是，当收到通知进行处理时，首先检查对应业务数据的状态，判断该通知是否已经处理过，如果没有处理过再进行处理，如果处理过直接返回结果成功。在对业务数据进行状态检查和处理之前，要采用数据锁进行并发控制，以避免函数重入造成的数据混乱。
特别提醒：商户系统对于支付结果通知的内容一定要做签名验证，防止数据泄漏导致出现“假通知”，造成资金损失。
技术人员可登进微信商户后台扫描加入接口报警群。

此通知接收地址为生成预付订单时设置的notify_url 。在开源项目weixin-guide中通知默认的地址为http://域名[/项目名称]/pay/pay_notify

以上是微信扫码支付模式一的全过程。

扫码支付模式二

模式二与模式一相比，流程更为简单，不依赖设置的回调支付URL。商户后台系统先调用微信支付的统一下单接口，微信后台系统返回链接参数code_url，商户后台系统将code_url值生成二维码图片，用户使用微信客户端扫码后发起支付。注意：code_url有效期为2小时，过期后扫码不能再发起支付。

微信支付的统一下单接口具体实现上文也有提及到，如果还不是很清楚可以看 com.javen.weixin.controller.WeixinPayController中的scanCode2 以及官方文档介绍

以下是调用预付订单返回的xml

<xml><return_code><![CDATA[SUCCESS]]></return_code>
<return_msg><![CDATA[OK]]></return_msg>
<appid><![CDATA[wx5e9360a3f46f64cd]]></appid>
<mch_id><![CDATA[1322117501]]></mch_id>
<nonce_str><![CDATA[XdVf2zXLErIHRfJn]]></nonce_str>
<sign><![CDATA[916703CD13C3615B9B629C4A9E4C3337]]></sign>
<result_code><![CDATA[SUCCESS]]></result_code>
<prepay_id><![CDATA[wx2016101514433661797ee3010493199442]]></prepay_id>
<trade_type><![CDATA[NATIVE]]></trade_type>
<code_url><![CDATA[weixin://wxpay/bizpayurl?pr=WWOXnrb]]></code_url>
</xml>

其中code_url 就是生成二维码的链接

String qrCodeUrl = result.get("code_url");
  String name = "payQRCode1.png";
  Boolean encode = ZxingKit.encode(qrCodeUrl, BarcodeFormat.QR_CODE, 3, ErrorCorrectionLevel.H, "png", 200, 200,
    PathKit.getWebRootPath()+File.separator+"view"+File.separator+name );
  if (encode) {
   //在页面上显示
   setAttr("payQRCode", name);
   render("payQRCode.jsp");
  }

扫码即可进行支付，code_url有效期为2小时，过期后扫码不能再发起支付

最终生成二维码访问地址为http://域名[/项目名称]/pay/scanCode2

码字完毕，以上就是微信扫码支付（模式一、模式二）的详细介绍。

欢迎留言、转发
微信极速开发系列文章：http://www.jianshu.com/p/a172a1b69fdd

后续更新预告
1、刷卡支付
2、微信红包
3、企业转账

微信公众号开发之扫码支付

微信扫码支付文档

扫码支付分为以下两种方式：

扫码支付模式一

1、设置支付回调URL

2、根据微信支付规则链接生成二维码

2.1 生成二维码规则

2.2 生成二维码并在页面上显示

3、扫码回调商户支付URL

4、根据回调参数生成预付订单进行支付

5、支付结果通用通知

官方文档点击这里

扫码支付模式二

猜你喜欢

热点阅读

微信公众号开发之扫码支付

微信扫码支付文档

扫码支付分为以下两种方式：

扫码支付模式一

1、设置支付回调URL

2、根据微信支付规则链接生成二维码

2.1 生成二维码规则

2.2 生成二维码并在页面上显示

3、扫码回调商户支付URL

4、根据回调参数生成预付订单进行支付

5、支付结果通用通知

官方文档 点击这里

扫码支付模式二

猜你喜欢

热点阅读

官方文档点击这里