前言
本篇文章主要是記錄本人在微信掃碼支付過程中所遇到的問題,給大家一個(gè)借鑒作用杉武,希望對你們有幫助
開發(fā)環(huán)境
- nodejs
v8.1.0
- egg
v1.1.0
準(zhǔn)備工作
- 微信公眾號-appid
- 微信商戶號-mch_id
- key值(簽名算法所需,其實(shí)就是一個(gè)32位的密碼狐血,可以用md5生成一個(gè))(key設(shè)置路徑:微信商戶平臺(pay.weixin.qq.com)-->賬戶設(shè)置-->API安全-->密鑰設(shè)置)
掃碼支付-統(tǒng)一下單
以下才用的是微信模式二,因?yàn)楸容^簡單
let MD5 = require('md5'),
xml2js = require('xml2js'),
url = "https://api.mch.weixin.qq.com/pay/unifiedorder",// 下單請求地址
appid = '公眾號id',
mch_id = '微信商戶號';
notify_url = '回調(diào)地址',
out_trade_no = '自己設(shè)置的訂單號',// 微信會(huì)有自己訂單號逼纸、我們自己的系統(tǒng)需要設(shè)置自己的訂單號
total_fee = '訂單金額',// 注意,單位為分
body = '商品簡單描述',
trade_type = 'NATIVE',// 交易類型济蝉,JSAPI--公眾號支付杰刽、NATIVE--原生掃碼支付、APP--app支付
nonce_str = moment().format('YYYYMMDDHHmmssSSS'),// 隨機(jī)字符串32位以下
stringA = `appid=${公眾號id}&body=${body}&mch_id=${微信商戶號}&nonce_str=${nonce_str}¬ify_url=${
notify_url}&out_trade_no=${out_trade_no}&spbill_create_ip=${ctx.request.ip}&total_fee=${total_fee}&trade_type=${trade_type}`,
stringSignTemp = stringA + "&key=xxxxxxxxxxxxxxxxx", //注:key為商戶平臺設(shè)置的密鑰key
sign = MD5(stringSignTemp).toUpperCase(); //注:MD5簽名方式
以上就是我們所需要的一些參數(shù)
簽名生成算法見微信官方
spbill_create_ip 是 終端ip地址
下面把所有的參數(shù)拼接成xml
const formData = "<xml>";
formData += "<appid>" + appid + "</appid>"; //appid
formData += "<body>" + body + "</body>"; //商品或支付單簡要描述
formData += "<mch_id>" + mch_id + "</mch_id>"; //商戶號
formData += "<nonce_str>" + nonce_str + "</nonce_str>"; //隨機(jī)字符串王滤,不長于32位
formData += "<notify_url>" + notify_url + "</notify_url>"; //支付成功后微信服務(wù)器通過POST請求通知這個(gè)地址
formData += "<out_trade_no>" + out_trade_no + "</out_trade_no>"; //訂單號
formData += "<total_fee>" + total_fee + "</total_fee>"; //金額
formData += "<spbill_create_ip>" + ctx.request.ip + "</spbill_create_ip>"; //ip
formData += "<trade_type>NATIVE</trade_type>"; //NATIVE會(huì)返回code_url 贺嫂,JSAPI不會(huì)返回
formData += "<sign>" + sign + "</sign>";
formData += "</xml>";
// 這里使用了egg里面請求的方式
const resultData = yield ctx.curl(url, {
method: 'POST',
content: formData,
headers: {
'content-type': 'text/html',
},
});
// xml轉(zhuǎn)json格式
xml2js.parseString(resultData.data, function (err, json) {
if (err) {
new Error("解析xml報(bào)錯(cuò)")
} else {
var result = formMessage(json.xml); // 轉(zhuǎn)換成正常的json 數(shù)據(jù)
console.log(result) //打印出返回的結(jié)果
}
})
var formMessage = function (result) {
var message = {};
if (typeof result === 'object') {
var keys = Object.keys(result);
for (var i = 0; i < keys.length; i++) {
var item = result[keys[i]];
var key = keys[i];
if (!(item instanceof Array) || item.length === 0) {
continue;
}
if (item.length === 1) {
var val = item[0];
if (typeof val === 'object') {
message[key] = formMessage(val);
} else {
message[key] = (val || '').trim();
}
} else {
message[key] = [];
for (var j = 0, k = item.length; j < k; j++) {
message[key].push(formMessage(itemp[j]));
}
}
}
}
return message;
}
上面使用了egg的請求方式,原生node可以使用request
var request = require('request');
request({
url: url,
method: "POST",
body: formData
}, function(error, response, body) {
if (!error && response.statusCode == 200) {
}
});
如果請求成功會(huì)最終返回一個(gè)xml,然后我們進(jìn)行解析成json的格式,里面會(huì)有一個(gè)code_url
和out_trade_no
,我們需要把這兩個(gè)返回給前端雁乡,然后通過生成二維碼展示給用戶掃碼第喳,完成支付
監(jiān)聽支付是否成功
上面操作完成之后,我們需要知道用戶是否完成支付踱稍,因?yàn)橛脩魰?huì)停留在該頁面曲饱,我們需要在用戶付完款之后悠抹,通知用戶支付成功。
首先扩淀,用戶發(fā)起支付的時(shí)候我們會(huì)生成二維碼楔敌,讓用戶完成掃碼支付,我們還要做的是引矩,開一個(gè)定時(shí)器梁丘,每隔一段時(shí)間去發(fā)送一個(gè)請求,這個(gè)時(shí)候旺韭,我們node后臺就需要寫一個(gè)查詢訂單的接口氛谜,之前我們拿到了out_trade_no
,也就是我們系統(tǒng)內(nèi)部的訂單號区端,我們把這個(gè)數(shù)據(jù)發(fā)送給后臺查詢訂單的接口值漫,然后后臺接收到之后會(huì)請求微信的查詢接口地址https://api.mch.weixin.qq.com/pay/orderquery
,流程跟上面一樣,只是接口地址和微信返回的xml不一樣而已织盼,返回的字段會(huì)有一個(gè)狀態(tài)即SUCCESS
和NOTPAY
杨何,我們可以通過判斷是否支付返回給前端,成功之后提示給用戶支付成功沥邻,關(guān)閉定時(shí)器危虱。
回調(diào)地址
這個(gè)是非常重要的一環(huán),大部分的操作其實(shí)在上面就可以完成唐全,但是有特殊的情況埃跷,比如用戶電腦斷網(wǎng)發(fā)送不了請求,但是手機(jī)付款了邮利,這就會(huì)導(dǎo)致我們記錄不到用戶支付的信息弥雹。這個(gè)時(shí)候回調(diào)地址就很重要了
設(shè)置回調(diào)地址
微信商戶中心->產(chǎn)品中心->開發(fā)配置->掃碼支付
之后我們需要做的是后端用post
來接收微信發(fā)送的異步回調(diào)信息,也是xml
的格式延届,這里注意剪勿,如果不支持接收xml,可能會(huì)得到空的數(shù)據(jù)
這里還需要注意的是方庭,我們在保存用戶支付信息的同時(shí)厕吉,得先查改訂單是否支付,以免重復(fù)操作械念,可能會(huì)插入多條記錄的情況
總結(jié)
微信掃碼支付坑還是有的头朱,如果你是第一次摸索的話,下面羅列一下需要注意的地方
- 簽名算法要寫正確订讼,不然是不會(huì)成功的,要拼接正確才行
- 微信返回的是xml格式的數(shù)據(jù)扇苞,我們得通過插件轉(zhuǎn)成json欺殿,這樣才方便獲取數(shù)據(jù)
- 返回的
code_url
要給前端生成二維碼用寄纵,然后需要開一個(gè)定時(shí)器查詢該訂單是否完成支付,最終通知用戶結(jié)果 - 回調(diào)地址很重要脖苏,我們后端需要
post
接收微信返回的回調(diào)信息程拭,然后保存信息,不過在保存用戶支付信息的之前棍潘,我們得知道該訂單是否已經(jīng)保存過恃鞋,以免重復(fù)添加。還有就是返回的是xml的數(shù)據(jù)亦歉,后端一定要保證能夠接收得到恤浪,按照正常的方式是接收不了的,得額外設(shè)置肴楷。
文章地址 nodejs微信支付之掃碼支付
個(gè)人博客地址 http://www.wclimb.site
GitHub地址 wclimb