微信原生支付流程以及踩坑
本次记录的是微信“JSAPI”的支付方式 也就是微信内H5页面调起支付,其他支付方式也大同小异,总体的流程和思路大致是一样的,基本配置方面就不详细记录,只需要商户号和商户Key,这个是配套的,还有跟商户号绑定的appid,在商户平台就可以实现绑定。
//组织参数统一下单(key注意字母大小写) TreeMap<String, String> treeMap = new TreeMap<>(); treeMap.put("appid",appid); //公众号的appid treeMap.put("mch_id",mchId); //商户号 treeMap.put("nonce_str",nonce_str); //32位随机字符串,,推荐随机数生成算法(每次下单不可重复) treeMap.put("body",body); //商品描述 treeMap.put("out_trade_no",orderNo); //商户订单号 32位随机字符串,推荐随机数生成算法(每次下单不可重复) treeMap.put("openid",openId); //微信用户的openid,trade_type=JSAPI时(即JSAPI支付),此参数必传(获取方式微信公众平台有方式) treeMap.put("total_fee",total_fee); //下单金额(分) treeMap.put("spbill_create_ip","127.0.0.1"); //下单ip地址 treeMap.put("notify_url",notify_url); //异步通知地址 treeMap.put("trade_type","JSAPI"); //交易类型 treeMap.put("sign_type","MD5"); //签名方式 String sign = MD5Util.createSign(treeMap, partnerkey); treeMap.put("sign",sign); String payUrl = WXPayConstants.UNIFIEDORDER_URL; //这里的xml拼接需要按照字母顺序先后拼接(参数都是统一下单存在的参数) //注意字母大小写 String xml="<xml>"+ "<appid>"+appid+"</appid>"+ "<body>"+body+"</body>"+ "<mch_id>"+mchId+"</mch_id>"+ "<nonce_str>"+nonce_str+"</nonce_str>"+ "<notify_url>"+notify_url+"</notify_url>"+ "<out_trade_no>"+orderNo+"</out_trade_no>"+ "<openid>"+openId+"</openid>"+ "<spbill_create_ip>"+"127.0.0.1"+"</spbill_create_ip>"+ "<sign_type>"+"MD5"+"</sign_type>"+ "<total_fee>"+total_fee+"</total_fee>"+ "<trade_type>"+"JSAPI"+"</trade_type>"+ "<sign><![CDATA["+sign+"]]></sign>"+ "</xml>"; //请求统一下单接口 String result = HttpRequest.doPost(payUrl, xml); //将成功返回的xml格式转为map格式(方便取值) Map<String, String> resultMap = XmlUtils.toMap(result.getBytes(), "UTF-8"); //判断返回条件是否满足 if(resultMap.get("return_code").equals("SUCCESS") && resultMap.containsKey("result_code") && resultMap.get("result_code").equals("SUCCESS")){ //下单成功,将订单信息存入库中 PayTradeFlow tradeFlow = new PayTradeFlow(); tradeFlow.setOutTradeNo(orderNo); //订单号 tradeFlow.setBody(""); //商品名称 tradeFlow.setWxStatus("等待付款"); //订单状态 tradeFlow.setTradeTime(new Date()); //订单发起时间 tradeFlow.setId(nonce_str); //订单id tradeFlow.setOpenid(""); //openid tradeFlow.setTotalFee(Integer.parseInt(AmountUtils.changeY2F(total_fee))); //支付金额 tradeFlow.setTradeType("JSAPI"); tradeFlow.setPayResult("SUCCESS"); int insert_code = payTradeFlowDao.insertSelective(tradeFlow); if (insert_code > 0){ //组织参数返回前端调起支付 JSONObject obj = new JSONObject(); //package参数需按照 package :prepay_id=123456789 格式拼接返回 obj.put("package","prepay_id="+resultMap.get("prepay_id"));//预支付交易标识 obj.put("nonceStr",resultMap.get("nonce_str")); //32位随机字符串 obj.put("appId",resultMap.get("appid")); //appid(统一下单时一样的) obj.put("signType","MD5"); //签名方式(跟统一下单时保持一致) obj.put("timeStamp",timeStamp); //时间戳(10位)不是当前毫秒值 //将调起支付的五个参数二次签名得到paySign一起返回前端 TreeMap<String, String> map = new TreeMap<>(); map.put("appId",resultMap.get("appid")); map.put("timeStamp",timeStamp); map.put("nonceStr",resultMap.get("nonce_str")); map.put("package","prepay_id="+resultMap.get("prepay_id")); map.put("signType","MD5"); // obj.put("paySign",WXPayUtil.generateSignature(map,partnerkey).toUpperCase()); obj.put("paySign",MD5Util.createSign(map,partnerkey).toUpperCase()); //二次签名paySign(需要转为大小) return ResponseEntity.createNormalJsonResponse(obj); } }
统一下单接口文档相关参数地址:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1
前端调起支付相关参数及说明文档地址:https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6
前端接收参数调起支付:
function pay() { var inputName = document.getElementById("name"); name = inputName.value; var inputMoney = document.getElementById("money"); money = inputMoney.value; if (name === '') { layer.msg("商品名称不能为空!"); return; } if (money === '') { layer.msg("充值金额不能为空!"); return; } $(function () { $.ajax({ url: "http://192.168.25.54:8083/services/wxPay/pay", //后台接口地址 type:"post", async: true, data:"{\"body\":\""+name+"\",\"totalFee\":\""+money+"\"}", //后台需要的参数 contentType: "application/json", Accept: "*/*", success: function (result) { var payInfo = eval("(" + result + ")"); if (payInfo.code == 0) { payInfo = payInfo.responseData; onBridgeReady(); function onBridgeReady() { WeixinJSBridge.invoke( 'getBrandWCPayRequest', {
//五个参数需要按照字母顺序 "appId": payInfo.appId, //公众号名称,由商户传入 "timeStamp": payInfo.timeStamp, //时间戳(10位),自1970 年以来的秒数 "nonceStr": payInfo.nonceStr, //32位随机串 "package": payInfo.package, //统一下单返回的prepay_id 预支付交易标识 "signType": payInfo.signType, //下单时签名方式: "paySign": payInfo.paySign, //后台二次签名得到的,不是统一下单返回的sign }, function (res) { if (res.err_msg == "get_brand_wcpay_request:ok") { //支付成功跳转页面 window.location.href = 'reg_history.html?accountId='; alert("支付成功") } if (res.err_msg == "get_brand_wcpay_request:cancel") { alert("您取消了"); WeixinJSBridge.call('closeWindow'); } if (res.err_msg == "get_brand_wcpay_request:fail") { alert("支付失败"); WeixinJSBridge.call('closeWindow'); } } ); } }else { layer.msg("系统错误!"); } } }); }) }
大致流程就是前端发起支付请求,后端统一下单生成预支付交易标识,然后组织5个参数二次签名生成paySign 返回给前端调起支付,
过程中容易出现的错误有两个地方:
1:前端接收到参数后签名验证失败(这个问题是多方面的,还是要仔细检查入参,字母大小写(统一下单时入参是appid,调起支付时是appId),参数个数是否对应,生成的签名需要转为大写字母)
2:前端调起支付时提示 -调用支付JSAPI缺少参数:total_fee(这个虽然提示是缺少金额,但实际上并不是,这个还是需要仔细检查入参和二次签名流程,字母大小写,无非就是这些问题)
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· 如何编写易于单元测试的代码
· 10年+ .NET Coder 心语,封装的思维:从隐藏、稳定开始理解其本质意义
· .NET Core 中如何实现缓存的预热?
· 从 HTTP 原因短语缺失研究 HTTP/2 和 HTTP/3 的设计差异
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 地球OL攻略 —— 某应届生求职总结
· 周边上新:园子的第一款马克杯温暖上架
· Open-Sora 2.0 重磅开源!
· 提示词工程——AI应用必不可少的技术
· .NET周刊【3月第1期 2025-03-02】