微信公众号开发之微信支付
前几天因为公司项目需求,要做一个用微信在线充值的功能,就是在微信的浏览器里面点击一个网页调起微信支付,现在大致来说一下微信支付之公众号支付的开发流程:
首先你的公众号必须是认证服务号,要开通了微信支付的权限;在开发写代码之前我们要把支付相关的一些信息设置做好,以利于后续操作,开通之后微信那边就会给你发一封邮件,里面包含了你公众号商户平台的后台登陆相关的一些信息,登陆商户平台之后在->账户设置->API安全里面设置密钥,这个在后面会用到;
账户参数说明
邮件中参数 | API参数名 | 详细说明 |
---|---|---|
APPID | appid | appid是微信公众账号或开放平台APP的唯一标识,在公众平台申请公众账号或者在开放平台申请APP账号后,微信会自动分配对应的appid,用于标识该应用。商户的微信支付审核通过邮件中也会包含该字段值。 |
微信支付商户号 | mch_id | 商户申请微信支付后,由微信支付分配的商户收款账号。 |
API密钥 | key | 交易过程生成签名的密钥,仅保留在商户系统和微信支付后台,不会在网络中传播。商户妥善保管该Key,切勿在网络中传输,不能在其他客户端中存储,保证key不会被泄漏。商户可根据邮件提示登录微信商户平台进行设置。 |
Appsecret | secret | AppSecret是APPID对应的接口密码,用于获取接口调用凭证access_token时使用。在微信支付中,先通过OAuth2.0接口获取用户openid,此openid用于微信内网页支付模式下单接口使用。在开发模式中获取AppSecret(成为开发者且帐号没有异常状态)。 |
这些完成之后我们还要了解一下公众号支付的一个业务流程:
商户系统和微信支付系统主要交互:
1.商户server调用统一下单接口请求订单,api参见公共api【统一下单API】;在请求预支付订单之前我们要调用微信OAuth2.0网页授权获取用户微信OpenId,这里就不详细说明了,下面是预支付下单的代码实现:
1 string timeStamp = TenPayUtil.GetTimestamp(); 2 string nonceStr = TenPayUtil.GetNoncestr(); 3 string paySign = string.Empty; 4 5 //创建支付应答对象 6 var packageReqHandler = new RequestHandler(null); 7 8 string spbill_create_ip = Request.UserHostAddress; 9 10 //初始化 11 //packageReqHandler.Init(); 12 //packageReqHandler.SetKey(TenPayInfo.Key); 13 //设置package订单参数 14 packageReqHandler.SetParameter("appid", appID); //公众账号ID 15 packageReqHandler.SetParameter("body", StrUtil.GetCutString(productName, 100)); //不能超过127个字符 16 packageReqHandler.SetParameter("mch_id", mchid); //商户号 17 packageReqHandler.SetParameter("nonce_str", nonceStr.ToLower()); //随机字符串 18 packageReqHandler.SetParameter("notify_url", notifyUrl); //接收财付通通知的URL 19 packageReqHandler.SetParameter("openid", openId); //openid 20 packageReqHandler.SetParameter("out_trade_no", sp_billno); //商家订单号 21 // packageReqHandler.SetParameter("attach", ""); //附加数据 未来可用于区分不同微信支付业务 22 packageReqHandler.SetParameter("spbill_create_ip", spbill_create_ip); //用户的公网ip,不是商户服务器IP 23 packageReqHandler.SetParameter("total_fee", (onlinePayMoney * 100).ToString("0")); //商品金额,以分为单位(money * 100).ToString() 24 packageReqHandler.SetParameter("trade_type", "JSAPI"); //交易类型 25 26 //获取package包 27 string sign = packageReqHandler.CreateMd5Sign("key", TenPayInfo.Key); 28 packageReqHandler.SetParameter("sign", sign); //交易类型 29 string data = packageReqHandler.ParseXML(); 30 LoggerHelper.Log(data); 31 32 //调用统一下单接口请求订单 33 var result = TenPayV3Service.Unifiedorder(data); 34 LoggerHelper.Log(result); 35 36 var res = XDocument.Parse(result); 37 38 string prepayId = string.Empty; 39 if (res.Element("xml").Element("return_code").Value == "SUCCESS") 40 { 41 prepayId = res.Element("xml").Element("prepay_id").Value; 42 } 43 44 string package = string.Format("prepay_id={0}", prepayId); 45 timeStamp = TenPayUtil.GetTimestamp(); 46 47 //设置支付参数 48 var paySignReqHandler = new RequestHandler(null); 49 paySignReqHandler.SetParameter("appId", appID); 50 paySignReqHandler.SetParameter("timeStamp", timeStamp); 51 paySignReqHandler.SetParameter("nonceStr", nonceStr); 52 paySignReqHandler.SetParameter("package", package); 53 paySignReqHandler.SetParameter("signType", "MD5"); 54 paySign = paySignReqHandler.CreateMd5Sign("key", TenPayInfo.Key); 55 56 //将信息传递给支付页面 57 ViewBag.appId = appID; 58 ViewBag.timeStamp = timeStamp; 59 ViewBag.nonceStr = nonceStr; 60 ViewBag.package = package; 61 ViewBag.paySign = paySign;
下面是页面js相关代码:
<script type="text/javascript"> // 当微信内置浏览器完成内部初始化后会触发WeixinJSBridgeReady事件。 document.addEventListener('WeixinJSBridgeReady', function onBridgeReady() { $(function () { //公众号支付 jQuery('#getBrandWCPayRequest').click(function (e) { WeixinJSBridge.invoke('getBrandWCPayRequest', { "appId": "@ViewBag.appId", //公众号名称 "timeStamp": "@ViewBag.timeStamp", //时间戳 "nonceStr": "@ViewBag.nonceStr", //随机串 "package": "@Html.Raw(ViewBag.package.ToString())",//扩展包 "signType": "MD5", //微信签名方式 "paySign": "@ViewBag.paySign" //微信签名 }, function (res) { if (res.err_msg == "get_brand_wcpay_request:ok") { //alert("微信支付成功!"); window.location.href = "@WxPaySettingConfig.WmallURL/Wmall/TradePay/Success/@ViewBag.ShopId/?orderNo=@orderNoMark"; } else if (res.err_msg == "get_brand_wcpay_request:cancel") { //alert("用户取消支付!"); } else { window.location.href = "/wxpay/jsapi/error/?isPayFail=1&csid=@ViewBag.ShopId&orderNo=@orderNoMark&biztype=1"; } // 使用以上方式判断前端返回,微信团队郑重提示:res.err_msg将在用户支付成功后返回ok,但并不保证它绝对可靠。 //因此微信团队建议,当收到ok返回时,向商户后台询问是否收到交易成功的通知,若收到通知,前端展示交易成功的界面;若此时未收到通知,商户后台主动调用查询订单接口,查询订单的当前状态,并反馈给前端展示相应的界面。 }); }); }); //WeixinJSBridge.log('yo~ ready.'); }, false); </script>
2.商户server接收支付通知,api参见公共api【支付结果通知API】
1 [HttpPost] 2 public void NoticeUrl() 3 { 4 string xmlString = HttpClientHelper.GetPostString(Request); 5 6 //此处应记录日志 7 LoggerHelper.Log(string.Format("【微支付】异步通知参数:{0}", xmlString)); 8 9 var returnMsg = new ReturnMessage() { Return_Code = "SUCCESS", Return_Msg = string.Empty }; 12 //通知消息实体 13 NotifyMessage message = null; 15 //订单处理相关的方法内全局变量 16 bool isNeedDeal = false; //标识订单是否需要处理 17 string orderNo = string.Empty; //订单编号 (需要根据商家数据包字段判断所属订单) 18 CorpSalesOrder saleOrder = null; 20 try 21 { 22 message = HttpClientHelper.XmlDeserialize<NotifyMessage>(xmlString); 23
26 //订单号 获得 27 orderNo = message.Out_Trade_No; 28 29 if (string.IsNullOrEmpty(orderNo)) 30 { 31 throw new InvalidOperationException("未找到该订单信息."); 32 } 45 var doc = new XmlDocument(); 46 doc.LoadXml(xmlString); 48 var dic = new Dictionary<string, string>(); 49 string sign = string.Empty; 50 foreach (XmlNode node in doc.FirstChild.ChildNodes) 51 { 52 if (node.Name.ToLower() != "sign") 53 dic.Add(node.Name, node.InnerText); 54 else 55 sign = node.InnerText; 56 } 57 UnifiedWxPayModel model = UnifiedWxPayModel.CreateUnifiedModel(xddAppId, xddMchid, xddWxkey); 58 if (model.ValidateMD5Signature(dic, sign)) 59 { 60 //处理通知 业务逻辑: 61 if (message.Return_Code == "SUCCESS") 62 { 63 if (message.Result_Code == "SUCCESS") 64 {
//此处处理支付成功后的业务逻辑 78 } 79 else 80 { 81 throw new InvalidOperationException(string.Format("{0}:{1}", message.Err_Code, message.Err_Code_Des)); 82 } 83 } 84 else 85 { 86 throw new InvalidOperationException(message.Return_Msg); 87 } 88 } 89 } 90 catch (InvalidOperationException e) 91 { 92 //此处记录异常日志 93 returnMsg.Return_Code = "FAIL"; 94 returnMsg.Return_Msg = e.Message; 95 LoggerHelper.Log("【微信支付异步通知】出错,订单编号:" + orderNo + ",错误原因:" + e.Message); 96 } 97 catch (Exception e) 98 { 99 //此处记录异常日志 100 returnMsg.Return_Code = "FAIL"; 101 returnMsg.Return_Msg = e.Message; 102 LoggerHelper.Log("【微信支付异步通知】出错,订单编号:" + orderNo + ",错误原因:" + (e.InnerException == null ? e.Message : e.InnerException.ToString())); 103 } 104 Response.Write(returnMsg.ToXmlString()); 105 Response.End(); 106 }
学无止境,贵在积累