官方对微信JSAPI的应用场景的解释是:

微信V3 支付 python demo 微信jsapi支付demo_JSAPI

 

官方的使用场景介绍是:商户已有H5商城网站,用户通过消息或扫描二维码在微信内打开网页时,可以调用微信支付完成下单购买的流程。点击 查看完整的场景介绍

 

我是在自己的微信公众号里调用此接口的,实现的效果如下图(图片来源于 微信官方文档):

微信V3 支付 python demo 微信jsapi支付demo_微信公众号_02

 

这个功能主要涉及到了两个接口,
接口一:当用户点击图一中的“立即支付”的时候调用该接口,此时后台就会调用微信支付的“统一下单”接口,点击 此处 查看微信官方提供的文档。接口调用成功后,后端会将请求得到一些数据封装好并返回给前端。前端只要调用一段js代码,就能实现图二中的效果。这里比较难的一点,就是在发起统一下单接口的时候,需要获取到用户的openId,我的项目在用户登录公众号的时候,就已经将openId保存到session中,而用户在调用H5付款的接口是做了登录拦击的,所以只要用户成功调用了接口一,那说明他就能拿到openId。感兴趣的可以参考我的另一篇博客 微信用户与第三方网站用户的绑定策略(实现用户第一次登陆后永久免登陆) 。如果无法保证准确获取到openId,不妨参考微信的 H5支付 来实现,这种支付方式,用户openId不是必传参数。

接口二:微信支付成功后的回调接口,跟前面那篇 JAVA后端调用微信支付“统一下单”接口实现微信二维码扫码支付 中的是同一个接口,具体可看那篇博客的说明。

 

下面开始上代码,先上依赖的jar包:

<!-- 微信支付开始-->
<!-- https://mvnrepository.com/artifact/org.jdom/jdom -->
<dependency>
    <groupId>org.jdom</groupId>
    <artifactId>jdom</artifactId>
    <version>1.1</version>
</dependency>

<!-- https://mvnrepository.com/artifact/xml-apis/xml-apis -->
<dependency>
    <groupId>xml-apis</groupId>
    <artifactId>xml-apis</artifactId>
    <version>1.0.b2</version>
</dependency>
<!-- 微信支付结束-->

 

然后是接口一和接口二的代码:

package wxpay;

import java.io.*;
import java.util.*;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.apache.commons.lang.StringUtils;
import org.apache.log4j.Logger;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/pay")
public class PayController {
	
	private static final Logger logger = Logger.getLogger(PayController.class);

	/**
	 * 接口一:从微信公众号发起微信H5支付接口
	 */
	@RequestMapping(value = "/toH5Pay", method = RequestMethod.POST)
	@ResponseBody
	public Result toWxPay(String orderId,String userId,Double amount,
			HttpServletRequest request) {

		Result dg = new Result();
		try {

			//我在用户登录时就会获取用户的openId并保存到session中,而当前这个接口又做了登录拦截,所以只要请求进来了,
			//就一定能获取到openId,但是为了保险起见,还是需要坐下判断
			String openId = (String) request.getSession().getAttribute("openId");
			if (StringUtils.isEmpty(openId)) {
				dg.setSuccess(false);
				dg.setMsg("没有获取到openId");
				return dg;
			}

			if(StringUtils.isBlank("orderId")||StringUtils.isBlank("userId")||amount==null){
				dg.setSuccess(false);
				dg.setMsg("缺少必要参数");
				return dg;
			}

			//个人核心业务隐身符,此处需要拿着orderId和userId为查询条件去数据库查询这个订单是否存在,
			//判断是否已经支付过了,同时还要携带这个金额是否已数据库中记录的商品实际金额一致
			//如果检验不通过,就不执行后面的操作
			//········

			String body = "平台-运费";//商品简单描述,该字段请按照规范传递,具体请见参数规定
			String attach = orderId+","+userId+","+amount+",wxpay";//附加数据,在查询API和支付通知中原样返回,可作为自定义参数使用。
			String totalFee = getMoney(amount+"");//订单总金额,单位为分,详见支付金额
			String device_info = "WEB";
			String spbill_create_ip = request.getRemoteAddr();
			String notify_url = "https://www.域名.cn/项目名/pay/wxRedirect";//异步接收微信支付结果通知的回调地址,通知url必须为外网可访问的url,不能携带参数。
			String trade_type = "JSAPI"; // 支付类型
			String nonce_str = UUID.randomUUID().toString().replace("-", "").substring(1, 32);

            //因为通常,一个网站接入微信支付,pc端接入的是微信Native支付,
            //微信公众号端接入的是JSAPI支付,app接入的是微信app支付,此外还有H5支付。
            //真实开发时遇到同一个订单号,如果开始使用二维码支付,获取二维码后没有扫码,
            //二维码依旧有效的时候,公众号那边发起JSAPI支付会失败。
            //不可能同一个订单使用不同的订单号,这个本身就很矛盾,
            //所以还是订单号后面追加标识用于区分,当然了支付回调接口在接收的时候
            //也要通过处理获取真实的订单号
			String out_trade_no = orderId+"_JSAPI";
			String mch_id = Constant.MCH_ID;
			String appId = Constant.APP_ID;

			SortedMap<String, String> packageParams = new TreeMap<String, String>();
			packageParams.put("appid", appId);
			packageParams.put("mch_id", mch_id);
			packageParams.put("nonce_str", nonce_str);
			packageParams.put("body", body);
			packageParams.put("attach", attach);
			packageParams.put("out_trade_no", out_trade_no);
			packageParams.put("total_fee", totalFee);
			packageParams.put("device_info", device_info);
			packageParams.put("notify_url", notify_url);
			packageParams.put("spbill_create_ip", spbill_create_ip);
			packageParams.put("trade_type", trade_type);
			packageParams.put("openid", openId);

			String sign = WXUtil.createSign(packageParams);
	        logger.info("生成的签名是:"+sign);
	        packageParams.put("sign", sign);

	         String xml =WXUtil.ArrayToXml(packageParams);
	         logger.info("map转换成xml的结果:"+xml);

			String createOrderURL = "https://api.mch.weixin.qq.com/pay/unifiedorder";

			Map<String, String> map = GetWxOrderno.getReturnUrl(createOrderURL, xml);
			logger.info("-----------------json-----------" + map);
			if (map != null) {

				map.put("timeStamp", Long.toString(System.currentTimeMillis() / 1000));
				map.put("signType", "MD5");

				SortedMap<String, String> params = new TreeMap<String, String>();
				params.put("appId", appId);
				params.put("timeStamp", map.get("timeStamp"));
				params.put("nonceStr", UUID.randomUUID().toString().replace("-", "").substring(1, 32).toUpperCase());
				params.put("package", "prepay_id=" + map.get("prepay_id"));
				params.put("signType", map.get("signType"));
				String paySign = WXUtil.createSign(params);

				map.put("paySign", paySign);
				map.put("nonce_str", params.get("nonceStr"));
				map.put("prepay_id", "prepay_id=" + map.get("prepay_id"));
				map.put("app_id", appId);
			}
			dg.setSuccess(true);
			logger.info("发起微信h5支付-----json-----------" + map);

			dg.setObj(map);

		} catch (Exception e) {
			dg.setSuccess(false);
			dg.setMsg("调用微信二维码失败:"+e.getMessage());
		}
		return dg;
	}

	String getMoney(String amount) {
		if (amount == null) {
			return "";
		}
		String currency = amount.replaceAll("\\$|\\¥|\\,", "");

		int index = currency.indexOf(".");
		int length = currency.length();
		Long amLong = 0l;
		if (index == -1) {
			amLong = Long.valueOf(currency + "00");
		} else if (length - index >= 3) {
			amLong = Long.valueOf((currency.substring(0, index + 3)).replace(
					".", ""));
		} else if (length - index == 2) {
			amLong = Long.valueOf((currency.substring(0, index + 2)).replace(
					".", "") + 0);
		} else {
			amLong = Long.valueOf((currency.substring(0, index + 1)).replace(
					".", "") + "00");
		}
		return amLong.toString();
	}


	/**
	 * 接口二:微信支付回调接口,不管是H5支付,还是微信二维码扫码支付,使用的是同一个回调接口
	 * 注意!注意!注意!这个接口不要做权限拦截操作,要直接放行
	 */
	@RequestMapping(value = "wxRedirect")
	@ResponseBody
	public void wxRedirect(HttpServletRequest req, HttpServletResponse resp) throws Exception {
		logger.info("微信支付回调开始了");

		// 创建支付应答对象
		ResponseHandler resHandler = new ResponseHandler(req, resp);
		// 读取参数
		InputStream inputStream = req.getInputStream();
		StringBuffer sb = new StringBuffer();
		BufferedReader in = new BufferedReader(new InputStreamReader(inputStream, "UTF-8"));
		String s;
		while ((s = in.readLine()) != null) {
			sb.append(s);
		}
		in.close();
		inputStream.close();

		// 解析xml成map
		Map<String, String> m =XMLUtil.doXMLParse(sb.toString());

		// 过滤空 设置 TreeMap
		SortedMap<Object, Object> packageParams = new TreeMap<Object, Object>();
		Iterator<String> it = m.keySet().iterator();

		while (it.hasNext()) {
			String parameter = it.next();
			String parameterValue = m.get(parameter);

			String v = "";
			if (null != parameterValue) {
				v = parameterValue.trim();
			}
			packageParams.put(parameter, v);
		}

		// 判断签名是否正确
		if (!PayCommonUtil.isTenpaySign("UTF-8", packageParams, Constant.MCH_KEY)) {
			logger.info("回调后发现签名失败了...");
			return ;
		}

		if (!"SUCCESS".equals(packageParams.get("result_code"))) {
			// 错误时,返回结果未签名,记录retcode、retmsg看失败详情。
			logger.info("查询验证签名失败或业务错误");
			return;
		}

		// 到这里,说明是支付成功了
		// 执行自己的业务逻辑

		// 通知id
		String mch_id = (String) packageParams.get("mch_id");
		String openid = (String) packageParams.get("openid");//付款方的openId
		String is_subscribe = (String) packageParams.get("is_subscribe");//是否关注公众号
		String out_trade_no = (String) packageParams.get("out_trade_no"); // 自己网站定义的订单号
		String attach = (String) packageParams.get("attach");//读取附带的参数
		String total_fee = (String) packageParams.get("total_fee");//支付金额
		String transaction_id = (String) packageParams.get("transaction_id");//微信那边生成的流水号,注意需要保存

		logger.info("attach:" + attach + ",mch_id:" + mch_id + ",openid:" + openid + ",is_subscribe:" + is_subscribe
				+ ",out_trade_no:" + out_trade_no + ",total_fee:" + total_fee + ",transaction_id:"+ transaction_id);

		//因为前面已经有定义格式:网站的订单号_支付标识 ,所以此处需要获取真实的订单号
		out_trade_no=out_trade_no.split("_")[0];
		logger.info("真正的订单号是:"+out_trade_no);


		// ----------- 处理业务开始 --------------
		logger.info("处理业务逻辑开始。。。");

		// 处理数据库逻辑,注意交易单不要重复处理,注意判断返回金额

		try {

			//注意我们原来定义的参数形式是这样的:orderId+","+userId+","+amount+",wxpay";
			String[] str = attach.split(",");
			if (str == null || str.length != 4) {
				logger.info("微信回调的attach参数错误,可能是非法请求");
				return;
			}

			String orderId = str[0];//自己网站定义的订单号
			String userId = str[1];//这个订单号对应的用户userId
			double amount = Double.parseDouble(str[2]);//订单金额
			String type = str[3];//用于标识此次微信支付是支付那种类型的金额,由自己定义;

			//执行到这里,应该单独往表中添加一条记录,用于记录微信付款成功了,注意这里应该使用独立的事务,
			// 防止后面的业务失败时,导致整个事务回滚。
			// 主要是为了将来排查错误使用,比如同一个订单,但是前面2分钟用户已经使用支付宝支付了,现在用户又用
			//微信支付了一遍,此时回调操作怎么处理呢?所以类似的这个回调成功的记录都必须要有,后面退款的时候可能需要用


			if ("wxpay".equals(type)) {
				logger.info("进入微信支付后续处理逻辑");

				//执行你自己的业务逻辑,比如设置订单为已支付,添加资金流水等
				//······

				//设置支付成功标志,不管你用哪种支付方式,只要这个订单支付成功了,就要设置这个标志
				RedisUtils.set("PAY_"+orderId,"1",60*60*24*30);//设置有效期30天,具体时间看你自己的业务

			}

		} catch (Exception e) {

			logger.info("回调错误:"+ e.getMessage());
		}

		logger.info("商家流水号:" + out_trade_no);// 其他字段也可用类似方式获取
		logger.info("FrontRcvResponse前台接收报文返回结束");
		// ------------------------------
		// 处理业务完毕
		// ------------------------------
		// 通知微信.异步确认成功.必写.不然会一直通知后台.八次之后就认为交易失败了.
		String resXml = "<xml>" + "<return_code><![CDATA[SUCCESS]]></return_code>"
				+ "<return_msg><![CDATA[OK]]></return_msg>" + "</xml> ";
		resHandler.sendToCFT(resXml);
	}

}

 

接着,在你的H5网页中执行JS调起支付,详情可参考官方文档:微信内H5调起支付

下面是具体的实现代码:

//点击“立即支付”,调用下面的这个函数
function pays() {
	$.ajax({
		type:"POST",
		url:"http://localhost:8080/项目名/pay/toH5Pay.do",
		data:{
			amount:"",
			userId:"",
			orderId:""
		},error:function(requst){
			pophint("系统错误,请稍后重试")
		},success:function(result){

			//请求成功了,开始解析数据
			eval("var r ="+result);
			
			if(r.success){
				var obj=r.obj;
				WeixinJSBridge.invoke('getBrandWCPayRequest',{  
	               "appId" : obj.app_id,
	             	"timeStamp":obj.timeStamp,  
	                "nonceStr" : obj.nonce_str,
	                "package" : obj.prepay_id,  
	                "signType" : obj.signType,
	                "paySign" : obj.paySign
	           },function(res){  
	                if(res.err_msg == "get_brand_wcpay_request:ok"){ 
	                	pophint("付款成功!",null,null,"javascript:window.history.back();return false;");	
	                }else{  
	                	pophint("付款失败");
	                	//此处,若用户取消付款(也就是退出公众号或者关闭那个输入密码的窗口),你可以执行一些自己的操作
	                }  
	       	 }); 
			}else{
				pophint(r.msg)
			}
		}
	});
}

 

剩下的一些java类(如下图所示),都可以在这篇博客 JAVA后端调用微信支付“统一下单”接口实现微信二维码扫码支付 找到,此处不再分享(补充:还有一个WXUtil.java文件也要引入,下图中漏掉了,但上面的这篇博客能找到)。

微信V3 支付 python demo 微信jsapi支付demo_微信V3 支付 python demo_03