導讀微信(WeChat)是騰訊公司于2011年1月21日推出的一個為智能終端提供即時通訊服務的免費應用程序,由張小龍所帶領的騰訊廣州研發(fā)中心產(chǎn)品團隊打造 [2] 。微信支持跨通信運營商、跨操作系統(tǒng)平臺... 微信(WeChat)是騰訊公司于2011年1月21日推出的一個為智能終端提供即時通訊服務的免費應用程序,由張小龍所帶領的騰訊廣州研發(fā)中心產(chǎn)品團隊打造 [2] 。微信支持跨通信運營商、跨操作系統(tǒng)平臺通過網(wǎng)絡快速發(fā)送免費(需消耗少量網(wǎng)絡流量)語音短信、視頻、圖片和文字,同時,也可以使用通過共享流媒體內(nèi)容的資料和基于位置的社交插件“搖一搖”、“漂流瓶”、“朋友圈”、”公眾平臺“、”語音記事本“等服務插件。 這次給大家?guī)砣绾问褂肒oa2開發(fā)微信二維碼掃碼支付,使用Koa2開發(fā)微信二維碼掃碼支付的注意事項有哪些,下面就是實戰(zhàn)案例,一起來看一下。前段時間在開發(fā)一個功能,要求是通過微信二維碼進行掃碼支付。這個情景我們屢見不鮮了,各種電子商城、線下的自動販賣機等等都會有這個功能。平時只是使用者,如今變?yōu)殚_發(fā)者,也是有不小的坑。所以特此寫一篇博客記錄一下。 注: 要開發(fā)微信二維碼支付,你必須要有相應的商戶號的權限,否則你是無法開發(fā)的。若無相應權限,本文不推薦閱讀。 兩種模式 打開微信支付的文檔,我們可以看到兩種支付模式:模式一和模式二。這二者的流程圖微信的文檔里都給出了(不過說實話畫得真的有點丑)。 文檔里指出了二者的區(qū)別: 模式一開發(fā)前,商戶必須在公眾平臺后臺設置支付回調(diào)URL。URL實現(xiàn)的功能:接收用戶掃碼后微信支付系統(tǒng)回調(diào)的productid和openid。 模式二與模式一相比,流程更為簡單,不依賴設置的回調(diào)支付URL。商戶后臺系統(tǒng)先調(diào)用微信支付的統(tǒng)一下單接口,微信后臺系統(tǒng)返回鏈接參數(shù)code_url,商戶后臺系統(tǒng)將code_url值生成二維碼圖片,用戶使用微信客戶端掃碼后發(fā)起支付。注意:code_url有效期為2小時,過期后掃碼不能再發(fā)起支付。 模式一是我們平時在網(wǎng)購的時候比較常見的,會彈出一個專門的頁面用于掃碼支付,然后支付成功后這個頁面會再次跳轉(zhuǎn)回回調(diào)頁面,通知你支付成功。第二種的話想對少一些,不過第二種開發(fā)起來相對簡單點。 本文主要介紹模式二的開發(fā) 。 搭建Koa2的簡單開發(fā)環(huán)境 快速搭建Koa2的開發(fā)環(huán)境我推薦可以使用koa-generator 。腳手架能幫我們省去Koa項目一開始的一些基本中間件的書寫步驟。(如果你想學習Koa最好自己搭建一個。如果你已經(jīng)會Koa了就可以使用一些快速腳手架了。) 首先全局安裝 npm install -g koa-generator #or yarn global add koa-generator 然后找一個目錄用來存放Koa項目,我們打算給這個項目取個名字叫做 npm install #or yarn 接著你可以輸入 如果不出意外,你的項目跑起來了,然后我們用postman測試一下: 這條路由是在 如果你看到了 { "title": "koa2 json" } 就說明沒問題。(如果有問題,檢查一下是不是端口被占用了等等。) 接下來在 簽名 跟微信的服務器交流很關鍵的一環(huán)是簽名必須正確,如果簽名不正確,那么一切都白搭。 首先我們需要去公眾號的后臺獲取我們所需要的如下相應的id或者key的信息。其中 簽名算法如下:https://pay.weixin.qq.com/wiki/doc/api/native.php?chapter=4_3 為了簽名正確,我們需要安裝一下 npm install md5 --save #or yarn add md5 const md5 = require('md5') const appid = 'xxx' const mch_id = 'yyy' const mch_api_key = 'zzz' const notify_url = 'http://xxx/api/notify' // 服務端可訪問的域名和接口 const server_ip = 'xx.xx.xx.xx' // 服務端的ip地址 const trade_type = 'NATIVE' // NATIVE對應的是二維碼掃碼支付 let body = 'XXX的充值支付' // 用于顯示在支付界面的提示詞 然后開始寫簽名函數(shù): const signString = (fee, ip, nonce) => { let tempString = `appid=${appid}&body=${body}&mch_id=${mch_id}&nonce_str=${nonce}¬ify_url=${notify_url}&out_trade_no=${nonce}&spbill_create_ip=${ip}&total_fee=${fee}&trade_type=${trade_type}&key=${mch_api_key}` return md5(tempString).toUpperCase() } 其中 由于跟微信的服務器交流都是用xml來交流,所以現(xiàn)在我們要手動組裝一下post請求的 const xmlBody = (fee, nonce_str) => { const xml = ` <xml> <appid>${appid}</appid> <body>${body}</body> <mch_id>${mch_id}</mch_id> <nonce_str>${nonce_str}</nonce_str> <notify_url>${notify_url}</notify_url> <out_trade_no>${nonce_str}</out_trade_no> <total_fee>${fee}</total_fee> <spbill_create_ip>${server_ip}</spbill_create_ip> <trade_type>NATIVE</trade_type> <sign>${signString(fee, server_ip, nonce_str)}</sign> </xml> ` return { xml, out_trade_no: nonce_str } } 如果你怕自己的簽名的 發(fā)送請求 因為需要跟微信服務端發(fā)請求,所以我選擇了 安裝過程不再贅述。繼續(xù)在 由于微信給我們返回的也將是一個xml格式的字符串。所以我們需要預先寫好解析函數(shù),將xml解析成js對象。為此你可以安裝一個 xml2js 。安裝過程跟上面的類似,不再贅述。 微信會給我們返回一個諸如下面格式的 <xml><return_code><![CDATA[SUCCESS]]></return_code> <return_msg><![CDATA[OK]]></return_msg> <appid><![CDATA[wx742xxxxxxxxxxxxx]]></appid> <mch_id><![CDATA[14899xxxxx]]></mch_id> <nonce_str><![CDATA[R69QXXXXXXXX6O]]></nonce_str> <sign><![CDATA[79F0891XXXXXX189507A184XXXXXXXXX]]></sign> <result_code><![CDATA[SUCCESS]]></result_code> <prepay_id><![CDATA[wx152316xxxxxxxxxxxxxxxxxxxxxxxxxxx]]></prepay_id> <trade_type><![CDATA[NATIVE]]></trade_type> <code_url><![CDATA[weixin://wxpay/xxxurl?pr=dQNakHH]]></code_url> </xml> 我們的目標是轉(zhuǎn)為如下的js對象,好讓我們用js來操作數(shù)據(jù): { return_code: 'SUCCESS', // SUCCESS 或者 FAIL return_msg: 'OK', appid: 'wx742xxxxxxxxxxxxx', mch_id: '14899xxxxx', nonce_str: 'R69QXXXXXXXX6O', sign: '79F0891XXXXXX189507A184XXXXXXXXX', result_code: 'SUCCESS', prepay_id: 'wx152316xxxxxxxxxxxxxxxxxxxxxxxxxxx', trade_type: 'NATIVE', code_url: 'weixin://wxpay/xxxurl?pr=dQNakHH' // 用于生成支付二維碼的鏈接 } 于是我們寫一個函數(shù),調(diào)用 // 將XML轉(zhuǎn)為JS對象 const parseXML = (xml) => { return new Promise((res, rej) => { xml2js.parseString(xml, {trim: true, explicitArray: false}, (err, json) => { if (err) { rej(err) } else { res(json.xml) } }) }) } 上面的代碼返回了一個 const axios = require('axios') const url = 'https://api.mch.weixin.qq.com/pay/unifiedorder' // 微信服務端地址 const pay = async (ctx) => { const form = ctx.request.body // 通過前端傳來的數(shù)據(jù) const orderNo = 'XXXXXXXXXXXXXXXX' // 不重復的訂單號 const fee = form.fee // 通過前端傳來的費用值 const data = xmlBody(fee, orderNo) // fee是費用,orderNo是訂單號(唯一) const res = await axios.post(url, { data: data.xml }).then(async res => { const resJson = await parseXML(res.data) return resJson // 拿到返回的數(shù)據(jù) }).catch(err => { console.log(err) }) if (res.return_code === 'SUCCESS') { // 如果返回的 return ctx.body = { success: true, message: '請求成功', code_url: res.code_url, // code_url就是用于生成支付二維碼的鏈接 order_no: orderNo // 訂單號 } } ctx.body = { success: false, message: '請求失敗' } } router.post('/api/pay', pay) module.exports = router 然后我們要將這個router掛載到根目錄的 找到之前默認的兩個路由,一個 const index = require('./routes/index') const users = require('./routes/users') const wechatpay = require('./routes/wechatpay') // 加在這里 然后到頁面底下掛載這個路由: // routes app.use(index.routes(), index.allowedMethods()) app.use(users.routes(), users.allowedMethods()) app.use(wechatpay.routes(), users.allowedMethods()) // 加在這里 于是你就可以通過發(fā)送 注意, 本例里是用前端來生成二維碼,其實也可以通過后端生成二維碼,然后再返回給前端。不過為了簡易演示,本例采用前端通過獲取 展示支付二維碼 前端我用的是 在前端,我使用的是 @xkeshi/vue-qrcode 這個庫來生成二維碼。它調(diào)用特別簡單: import VueQrcode from '@xkeshi/vue-qrcode' export default { components: { VueQrcode }, // ...其他代碼 } 然后就可以在前端里用 <vue-qrcode :value="codeUrl" :options="{ size: 200 }"> 放到Dialog里就是這樣的效果: 文本是我自己添加的
付款成功自動刷新頁面 有兩種將支付成功寫入數(shù)據(jù)庫的辦法。 一種是在打開了掃碼對話框后,不停向微信服務端輪詢支付結果,如果支付成功,那么就向后端發(fā)起請求,告訴后端支付成功,讓后端寫入數(shù)據(jù)庫。 一種是后端一直開著接口,等微信主動給后端的 第一種比較簡單但是不安全:試想萬一用戶支付成功的同時關閉了頁面,或者用戶支付成功了,但是網(wǎng)絡有問題導致前端沒法往后端發(fā)支付成功的結果,那么后端就一直沒辦法寫入支付成功的數(shù)據(jù)。 第二種雖然麻煩,但是保證了安全。所有的支付結果都必須等微信主動向后端通知,后端存完數(shù)據(jù)庫后再返回給前端消息。這樣哪怕用戶支付成功的同時關閉了頁面,下次再打開的時候,由于數(shù)據(jù)庫已經(jīng)寫入了,所以拿到的也是支付成功的結果。 所以 前端部分 Vue的data部分 data: { payStatus: false, // 未支付成功 retryCount: 0, // 輪詢次數(shù),從0-200 orderNo: 'xxx', // 從后端傳來的order_no codeUrl: 'xxx' // 從后端傳來的code_url } 在methods里寫一個查詢訂單信息的方法: // ... handleCheckBill () { return setTimeout(() => { if (!this.payStatus && this.retryCount < 120) { this.retryCount += 1 axios.post('/api/check-bill', { // 向后端請求訂單支付信息 orderNo: this.orderNo }) .then(res => { if (res.data.success) { this.payStatus = true location.reload() // 偷懶就用reload重新刷新頁面 } else { this.handleCheckBill() } }).catch(err => { console.log(err) }) } else { location.reload() } }, 1000) } 在打開二維碼Dialog的時候,這個方法就啟用了。然后就開始輪詢。我訂了一個時間,200s后如果還是沒有付款信息也自動刷新頁面。實際上你可以自己根據(jù)項目的需要來定義這個時間。 后端部分 前端到后端只有一個接口,但是后端有兩個接口。一個是用來接收微信的推送,一個是用來接收前端的查詢請求。 先來寫最關鍵的微信的推送請求處理。由于我們接收微信的請求是在Koa的路由里,并且是以流的形式傳輸?shù)摹P枰孠oa支持解析xml格式的body,所以需要安裝一個rawbody 來獲取xml格式的body。 // 處理微信支付回傳notify // 如果收到消息要跟微信回傳是否接收到 const handleNotify = async (ctx) => { const xml = await rawbody(ctx.req, { length: ctx.request.length, limit: '1mb', encoding: ctx.request.charset || 'utf-8' }) const res = await parseXML(xml) // 解析xml if (res.return_code === 'SUCCESS') { if (res.result_code === 'SUCCESS') { // 如果都為SUCCESS代表支付成功 // ... 這里是寫入數(shù)據(jù)庫的相關操作 // 開始回傳微信 ctx.type = 'application/xml' // 指定發(fā)送的請求類型是xml // 回傳微信,告訴已經(jīng)收到 return ctx.body = `<xml> <return_code><![CDATA[SUCCESS]]></return_code> <return_msg><![CDATA[OK]]></return_msg> </xml> ` } } // 如果支付失敗,也回傳微信 ctx.status = 400 ctx.type = 'application/xml' ctx.body = `<xml> <return_code><![CDATA[FAIL]]></return_code> <return_msg><![CDATA[OK]]></return_msg> </xml> ` } router.post('/api/notify', handleNotify) 這里的坑就是Koa處理微信回傳的xml。如果不知道是以 接下來這個就是比較簡單的給前端回傳的了。 const checkBill = async (ctx) => { const form = ctx.request.body const orderNo = form.orderNo const result = await 數(shù)據(jù)庫操作 if (result) { // 如果訂單支付成功 return ctx.body = { success: true } } ctx.status = 400 ctx.body = { success: false } } router.post('/api/check-bill', checkBill) 相信看了本文案例你已經(jīng)掌握了方法,更多精彩請關注php中文網(wǎng)其它相關文章! 推薦閱讀: 如何操作Koa2微信公眾號開發(fā)之本地開發(fā)調(diào)試環(huán)境搭建 以上就是如何使用Koa2開發(fā)微信二維碼掃碼支付的詳細內(nèi)容,更多請關注php中文網(wǎng)其它相關文章! 微信提供公眾平臺、朋友圈、消息推送等功能,用戶可以通過“搖一搖”、“搜索號碼”、“附近的人”、掃二維碼方式添加好友和關注公眾平臺,同時微信將內(nèi)容分享給好友以及將用戶看到的精彩內(nèi)容分享到微信朋友圈。 |
溫馨提示:喜歡本站的話,請收藏一下本站!