前言
前段時間在開發(fā)一個微信小程序的時候需要用到支付功能，我就去看了下微信支付的官方文檔，好家伙，微信官方只提供了java、php還有Go語言的sdk。PHP我會點吧，但又不是很會，做為一個菜雞前端，java也不會更別說go了。恰好我最近剛學了下nodejs，我就想找找有沒有人做nodejs版的sdk開源，在微信開發(fā)者社區(qū)逛了逛沒想到還真有，又可借此機會再復習一下nodejs也挺好的。在這里我將大致記錄一下我的一些使用方法。
支付流程
一、向后端服務器獲取支付所需參數(shù)
二、用獲得的參數(shù)調(diào)用小程序內(nèi)置的的支付api
三、在回調(diào)的后端接口中處理業(yè)務邏輯
在微信小程序發(fā)起支付
查看微信小程序的官方文檔，我們可以查到微信小程序發(fā)起支付的api
wx.requestPayment({
timeStamp: '',
nonceStr: '',
package: '',
signType: 'MD5',
paySign: '',
success (res) { },
fail (res) { }
})
可以看到這里需要我們攜帶五個參數(shù)( timeStamp， nonceStr，package，signType,，paySign)才能正常發(fā)起支付。
那我們要在哪里才能獲取到這些參數(shù)呢，這就需要我們的nodejs上場了。
支付模塊
使用npm安裝
npm i wechatpay-node-v3
這個包集成了H5、App端的支付能力，更多詳細的介紹可以去看一下這個包的官方文檔，這里就只介紹在微信小程序的應用。
引入依賴包
const WxPay = require('wechatpay-node-v3');
const fs = require('fs');
const request = require('superagent');
const express = require('express');
其中fs是一個文件處理的內(nèi)置模塊模塊，superagent是一個發(fā)起請求的模塊，若沒有的話使用npm提前安裝一下，這里就不多做介紹了。因為我們需要搭建一個可供前端請求的接口，我們就需要用到express服務器搭建框架，同樣也是需要使用npm提前安裝一下的。
創(chuàng)建支付實例
const pay = new WxPay({
appid: '你的微信小程序appid',
mchid: '商戶號',
publicKey: fs.readFileSync('./apiclient_cert.pem'), // 公鑰
privateKey: fs.readFileSync('./apiclient_key.pem'), // 秘鑰
});
其中商戶號需要憑營業(yè)執(zhí)照才能申請，個人是無法接入微信支付的。
申請到商戶號之后還需要在微信小程序的管理平臺關聯(lián)一下商戶號。
[圖片上傳失敗...(image-4db02-1659874608973)]
然后還需要去申請公鑰和私鑰證書。具體的申請流程可看下方微信官方的文檔：微信支付接入前準備
之后把申請的公鑰私鑰證書文件放到同級目錄下。
[圖片上傳失敗...(image-184c81-1659874608973)]
獲取支付參數(shù)
async function payInfo(req,res){
const params = {
description: 'Asnull的支付測試', // 訂單描述
out_trade_no: '2022080711111111', // 訂單號，一般每次發(fā)起支付都要不一樣，可使用隨機數(shù)生成
notify_url: 'https://pay.lipux.cn/notify_url',
amount: {
total: 1, // 支付金額，單位為分
},
payer: {
openid: 'drEc8QfY', // 微信小程序用戶的openid，一般需要前端發(fā)送過來
},
scene_info: {
payer_client_ip: 'ip', // 支付者ip，這個不用理會也沒有問題
},
};
const result = await pay.transactions_jsapi(params);
console.log(result);
}
其中的回調(diào)url是當用戶成功支付之后微信服務器就會向這個回調(diào)url發(fā)支付結果的信息，一般我們是在這個回調(diào)url里面進行一些支付成功之后的業(yè)務處理，而且這個回調(diào)url是需要ssl證書認證的也就是https，且在鏈接后面不能攜帶參數(shù)。url示例：https://pay.lipux.cn/notify_url
注意：這個回調(diào)url必須能公網(wǎng)訪問的哦，不能是本地環(huán)境的鏈接
由于pay.transactions_jsapi返回的是一個promise對象，因此我們使用async和await函數(shù)進行接收結果，其中result就是微信小程序api發(fā)起支付所需要的參數(shù)。
result的打印結果：
{
appId: 'drEc8QfY',
timeStamp: '1609918952',
nonceStr: 'y8aw9vrmx8c',
package: 'prepay_id=wx0615423208772665709493edbb4b330000',
signType: 'RSA',
paySign: 'JnFXsT4VNzlcamtmgOHhziw7JqdnUS9qJ5W6vmAluk3Q2nska7rxYB4hvcl0BTFAB1PBEnHEhCsUbs5zKPEig==
}
我們將這個結果使用express中的路由監(jiān)聽res.send()函數(shù)發(fā)送給前端就可以了。
然后我們就在前端解析這些數(shù)據(jù)，放到wx.requestPayment這個微信小程序的api中正式發(fā)起支付。
如果不出意外的話，在微信小程序發(fā)起支付這個功能我們就正式實現(xiàn)了。
處理業(yè)務邏輯
上面提到了，回調(diào)url就是一個處理支付成功之后的業(yè)務邏輯的接口。
當支付成功之后，微信服務器會向我們這個接口發(fā)送一個post請求，這個post請求攜帶了一些有關支付結果的參數(shù)
支付結果通知是以POST 方法訪問商戶設置的通知url，通知的數(shù)據(jù)以JSON 格式通過請求主體（BODY）傳輸。通知的數(shù)據(jù)包括了加密的支付結果詳情。
通過官方微信支付文檔的上面這個話可知，微信服務器向我們發(fā)送的是一段加密的數(shù)據(jù)，但別擔心，這個模塊的作者都幫我們解決了。
我們先來看一下微信服務器都給我們發(fā)送了什么數(shù)據(jù)：
{
"id": "091541fc-6sca-55v8-ab24-653a9v313500",
"create_time": "2022-08-07T16:39:06+08:00",
"resource_type": "encrypt-resource",
"event_type": "TRANSACTION.SUCCESS",
"summary": "支付成功",
"resource": {
"original_type": "transaction",
"algorithm": "AEAD_AES_256_GCM",
"ciphertext": "tMqPpq3VCxwt56hU2gfsPDJfcfESQ/kzPNmi2xYF0KqMV9ChIWu+n5iVXSVqwgsU9gYSSXeThhp3jm8i9pcrTiOagMxEM/IbJ+MfnN7fkr8Jy2tWOg49N4wy3vB2Qd/nJvD+Jz8K6c4rF8MOasgN+XEriut23sd6EqGUY5zTaKQ+yZC7Q5R+Q6UXa4HlsvHH7+wL6Uz71ZqNyawJ7BYGGh2aXwTu3DHMOullL/IoG3E1nRq1xQRmJsn0li4okegLRuTmlp3vvxZcNgHLOZSCmtdYcRYsZezB2wYdqsT5cCUmRgO8CdgctkGGQIOTjlgaKT8gogP7XUvw1bcFMAC4HqUJv2v28mfMTjFzhLNXXWCFDKJDWhCQg2ZTXw0pRJSYe/IiNBpuVsKX7DGahOyYly/Hn321fryiH7mpI5orC6Wb03Mc77hcnL9ALDV0jT8mrmYuB8pAMkxsFNcGcgnp5FrtKcA59CEYc4ccNU26wIiIszB0YIwvirvCEGys3eGStQaytFLvGw5qCmnZ6N5X3GPBOPEQXJa19CrVndWMjBm1PaeyJ/fgfN9mGrsChrToxDg==",
"associated_data": "transaction",
"nonce": "iOO0tvICpQFb"
}
}
我們可以看到其中有段信息是被加密了，我們需要解密其中的信息才能進一步的進行我們業(yè)務處理。
解密回調(diào)結果
我們需要通過在回調(diào)的路由監(jiān)聽的req.body拿到發(fā)送的數(shù)據(jù)，即上面那一段的json數(shù)據(jù)，把對應的ciphertext, associated_data, nonce參數(shù)傳入下面的函數(shù)：
# key 用商戶平臺上設置的APIv3密鑰【微信商戶平臺—>賬戶設置—>API安全—>設置APIv3密鑰】，記為key；
const result = pay.decipher_gcm(ciphertext, associated_data, nonce, key);
其中的key是APIv3密鑰，需要我們?nèi)チ硗馍暾?，具體申請流程請看下面的官方文檔：什么是APIv3密鑰？如何設置？ (qq.com)
解密成功之后我們就拿到一個新的結果result，打印出來如下：
{
"mchid": "3526524578",
"appid": "wxc2n10fbb6065d4f0",
"out_trade_no": "2022080711111111",
"transaction_id": "8520001545602207282059123413",
"trade_type": "JSAPI",
"trade_state": "SUCCESS",
"trade_state_desc": "支付成功",
"bank_type": "OTHERS",
"attach": "",
"success_time": "2022-08-07T16:55:20+08:00",
"payer": {
"openid": "drEc8QfY"
},
"amount": {
"total": 1,
"payer_total": 1,
"currency": "CNY",
"payer_currency": "CNY"
}
}
其中的out_trade_no就是我們一開始設置的訂單號，我們可以在一開始的時候就把這個訂單號與我們的用戶進行關聯(lián)，然后在這里就可以通過訂單號進行業(yè)務處理，比如說充值會員，充值金幣等等的操作。
關于回調(diào)通知的具體參數(shù)說明可看文檔：微信支付-開發(fā)者文檔 (qq.com)
到這里，我們已經(jīng)完成了整個微信小程序支付的流程，不出意外的話你應該可以正常拿到支付的結果
剩下的就是你的業(yè)務邏輯了！
完整代碼
/*
* Created by Asnull.
* Website:https://lipux.cn/
*/
const WxPay = require('wechatpay-node-v3');
const fs = require('fs');
const request = require('superagent');
const express = require('express');
// 創(chuàng)建服務器實例
const app = express();
// 配置解析表單數(shù)據(jù)的中間件
app.use(express.urlencoded({ extended: false }))
app.use(express.json())
// 監(jiān)聽端口
app.listen(3031, () => {
console.log('服務器啟動成功！')
})
// 創(chuàng)建支付實例
const pay = new WxPay({
appid: '你的微信小程序appid',
mchid: '商戶號',
publicKey: fs.readFileSync('./apiclient_cert.pem'), // 公鑰
privateKey: fs.readFileSync('./apiclient_key.pem'), // 秘鑰
});
// 定義一個獲取支付參數(shù)路由（get請求）
app.get('/pay', payInfo);
// 拿到支付所需參數(shù)
async function payInfo(req, res) {
// 接收前端傳過來的openid
let openid = req.params.openid;
const params = {
description: 'Asnull的支付測試', // 訂單描述
out_trade_no: randomNumber(), // 訂單號，一般每次發(fā)起支付都要不一樣，可使用隨機數(shù)生成
notify_url: 'https://pay.lipux.cn/notify_url',
amount: {
total: 1, // 支付金額，單位為分
},
payer: {
openid: openid, // 微信小程序用戶的openid，一般需要前端發(fā)送過來
},
scene_info: {
payer_client_ip: 'ip', // 支付者ip，這個不用理會也沒有問題
},
};
const result = await pay.transactions_jsapi(params);
console.log(result);
// 將結果響應給微信小程序前端
res.send(result);
}
// 回調(diào)路由
app.post('/notify_url', async(req, res) => {
// 申請的APIv3
let key = '45c18fdfdgd45f5bc5321201dfdf453f';
let { ciphertext, associated_data, nonce } = req.body.resource;
// 解密回調(diào)信息
const result = pay.decipher_gcm(ciphertext, associated_data, nonce, key);
// 拿到訂單號
let { out_trade_no } = result;
if (result.trade_state == 'SUCCESS') {
// 支付成功之后需要進行的業(yè)務邏輯
}
})
// 訂單號生成函數(shù)
function randomNumber() {
const now = new Date()
let month = now.getMonth() + 1
let day = now.getDate()
let hour = now.getHours()
let minutes = now.getMinutes()
let seconds = now.getSeconds()
month = month < 10 ? "0" + month : month;
day = day < 10 ? "0" + day : day;
hour = hour < 10 ? "0" + hour : hour;
minutes = minutes < 10 ? "0" + minutes : minutes;
seconds = seconds < 10 ? "0" + seconds : seconds;
let orderCode = now.getFullYear().toString() + month.toString() + day + hour + minutes + seconds + (Math.round(Math.random() * 1000000)).toString();
return orderCode;
}
最后
nodejs項目成功部署到服務器之后，我們只需要在微信小程序先對https://域名/pay 發(fā)起get請求
拿到數(shù)據(jù)后再調(diào)用wx.requestPayment即可發(fā)起支付。
最后，祝您玩的愉快！
