先贴出github链接 完整代码点此进入 https://github.com/yangfuhe/node-wxpay
功能概述
完成模块
jsapi,native,h5,app统一下单,付款交易查询,退款,退款交易查询,解密通知参数,公钥获取,验证签名,交易账单,资金账单,下载账单支付模式支持
付款码/公众号/小程序/APP/H5/扫码支付
使用前必读
版本要求
nodejs >= 8.3.0
安装
npm i wxpay-v3 --save
# 如已安装旧版, 重新安装最新版
npm i wxpay-v3@latest
实例化
const Payment = require('wxpay-v3');
const paymnet = new Payment({
appid: '公众号ID',
mchid: '微信商户号',
private_key: require('fs').readFileSync('*_key.pem证书文件路径').toString(),//或者直接复制证书文件内容
serial_no:'证书序列号',
apiv3_private_key:'api v3密钥',
notify_url: '支付退款结果通知的回调地址',
})
config说明:
appid
- 公众号ID(必填)mchid
- 微信商户号(必填)private_key
- 商户API证书*_key.pem中内容 可在微信支付平台获取(必填, 在微信商户管理界面获取)serial_no
- 证书序列号(必填, 证书序列号,可在微信支付平台获取 也可以通过此命令获取(*_cert.pem为你的证书文件) openssl x509 -in *_cert.pem -noout -serial )apiv3_private_key
- apiv3密钥 在创建实例时通过apiv3密钥会自动获取平台证书的公钥,以便于验证签名(必填)-
notify_url
- 支付退款结果通知的回调地址(选填)可以在初始化的时候传入设为默认值, 不传则需在调用相关API时传入
调用相关API时传入新值则使用新值
jsapi统一下单
let result = await payment.jsapi({
description:'点存云-测试支付',
out_trade_no:Date.now().toString(),
amount:{
total:1
},
payer:{
openid:'ouEJk65CZr8_7eb95RIPDNWZKrvI'
},
})
console.log(result)
app统一下单
let result = await payment.app({
description:'点存云-测试支付',
out_trade_no:Date.now().toString(),
amount:{
total:1
}
})
console.log(result)
h5统一下单
let result = await payment.h5({
description:'点存云-测试支付',
out_trade_no:Date.now().toString(),
amount:{
total:1
},
scene_info:{
payer_client_ip:'203.205.219.187'
}
})
console.log(result)
native统一下单
let result = await payment.native({
description:'点存云-测试支付',
out_trade_no:Date.now().toString(),
amount:{
total:1
}
})
console.log(result)
通过transaction_id查询订单
let result = await payment.getTransactionsById({
transaction_id:'4200000928202103013162567337'
})
console.log(result)
通过out_trade_no查询订单
let result = await payment.getTransactionsByOutTradeNo({
out_trade_no:'1614602083807'
})
console.log(result)
关闭订单
let result = await payment.close({
out_trade_no:'1614602083807'
})
console.log(result)
退款
let result = await payment.refund({
transaction_id:'4200000902202103026804947229',
//out_trade_no:'1614602083807',
out_refund_no:Date.now().toString(),
amount:{
refund:1,
total:1,
currency:'CNY'
}
})
console.log(result)
查询单笔退款订单
let result = await payment.getRefund({
out_refund_no:'1614757507992',
})
console.log(result)
获取平台证书列表
let result = await payment.getCertificates()
console.log(result)
解密支付退款通知参数
let result = await payment.decodeParams({
"original_type":"refund",
"algorithm":"AEAD_AES_256_GCM",
"ciphertext":"d2Zi2VToOGXqB3K6bgQaFKktgA3AHm+cJg0vGZPcD22OUZ+CBymtrFJsFtaKKEwebSDN8Habic7NJVpKJpAxZd8ejm32v4UePg139/gj+X7vJtqB39ZkjZXLH973LT5R5yZQ351R3onlpx9JILN2+FNEbrUNenjgEufuQn45b9jwGSBX/sU6n/+gsCdt8+sSkbMy37sSX1bjMicHzte27fR0QSuO1TDjZjjDqP2ou0j7Jb+x9RRtWlbZ1hOYe7AhSTFzOXvkdCq0M6P6ja1cc2olV9xG8UzKxZN0JLnoqIGWwPzTVOPqmt/N3/MrzCK3TT1mNagBnhqEvSXhL9KUjpAIY8J6tkjfoG+9QwnJA8kW48C3nGsgePvNYvikJooQii7rx78Y2paR7cS8Pn8+sxKg4q91DiovBSdW2/ePDruI6SH/FWFrPmLQCG11fCjz/C9o6bqjaSsHKMaSVSAW9e/et04MP6GcZIDweG5AN9FgOXMI",
"associated_data":"refund",
"nonce":"AqfRSFm7h9Sa"
})
console.log(result)
验证签名
setTimeout(async ()=>{
//timestamp,nonce,serial,signature均在HTTP头中获取,body为请求参数
let result = await payment.verifySign({
timestamp:'1614829763',
nonce:'Eeumuhd3zA5TirWeJUCLCpkENYM8PSUA',
serial:'3DEA336346E96C002B7B0D514D424C8DEDBF9145',
signature:'ame3lX1y6FeXrlBN973M1Dhg5n77M1wVsD3VgeyZlb8c3dz/hpQ+9vNOMBBHGdv8kDIfZUxKDdfoeUaVJhfqAEn9ZV4x112ntEzCHpJtIXQ3rr8fScY7cO71EN/QyQHtY1Ovt8U2Yr891iYaLujUrBHtWrhiR6UKecRA+/RgsUBYh4D10rrqW5ywNrLVN+PSuG4QB85bz3jSslMvRrSG7HP/Xwo3e2sWMDuQ2Uadefu+8/FK1P3KDLDO2fq5teSaaqs7oof2WpV6zrVtyQ+P4p5t8NJ0ExlOSAs2xGJ0+xi+U996tq3VYZXf/4nVsfGW9rn0m/mOrYTmiST9PF+q1g==',
body:'{"id":"3b66121d-c9b9-5d61-9d92-eeec248e993d","create_time":"2021-03-04T11:49:23+08:00","resource_type":"encrypt-resource","event_type":"TRANSACTION.SUCCESS","summary":"支付成功","resource":{"original_type":"transaction","algorithm":"AEAD_AES_256_GCM","ciphertext":"PB305U6jR6TN8mBzbzGts5TaKnDXQt/7C+uJpGnvOT1SyCvI18L4f42eTZtrZv+5XUdOkxwEHGWDVl2MwbvpgLjLdjyisaHc+uRQCDoYlusiaeDJzd515Rl36nqmdPD8xFKZahWZBBkAlCgXLuW3qcdxSISTk/pyqPziwUtFKfMeq3LEEm4z8DfBM9cVXJrN8EiY2WaQsm+lGnZAV4+pxCELj67xmccXs3JgJwHSKE4exqW919atQWTwJHzuP3WNd+Xvp0zwm9RtDPTvZ8egehqqBw+DARC5jg8MmDtlMR2sTgH2xq6b4+QqLXPPIooOyvEZKMOteSI4FmSfPNwDfZ26D4ga9yGRIxSQKkWDq3QRNhOzvmSkCax08t2hdq12NxBSE9y7aZkjKIr4/uMEtKDU/3wcSoVKlawfN1hlCKo2nWbdKH1avRvc6FAFxXHtXRw0Y0MRnSk8gPMF/T+QqEMRJniXbrylt21xR0AEKbIVk0xK9jvhXex0AvST4x3eKM0r4DXkmL/pCjo1XmZLZIMc2uJ1jJEyqWcURXirrxADCATIAEWOu1hNL6PE","associated_data":"transaction","nonce":"KcsMoPx5UW1i"}}'
})
console.log(result)
},2000)
申请交易账单
let result = await payment.tradebill({
bill_date:'2021-03-03'
})
console.log(result)
申请资金账单
let result = await payment.fundflowbill({
bill_date:'2021-03-03'
})
console.log(result)
下载账单
let result = await payment.downloadbill('https://api.mch.weixin.qq.com/v3/billdownload/file?token=ktWgOuBvGNvmCk0NaOTMF41tG3yWsZrdM4zdgl10r1GRRNo4tG5V9mPi04ku-PY8&tartype=gzip')
console.log(result)