评论

微信支付v3 node sdk

使用 node 对接微信支付业务

ape-node-wechatpay-v3

如果您觉得这个SDK有帮助,请帮忙在 GitHub项目主页 点个赞,或者您对这个SDK有任何问题或建议,欢迎联系我。

目录

安装

用法介绍

内置方法介绍

版本介绍

安装

npm

npm i ape-node-wechatpay-v3 --save

weChatPay 用法介绍

创建 weChatPay 实例

创建实例

const apeWeChatPay = require("ape-node-wechatpay-v3");
const fs = require("fs");

const weChatPay = new apeWeChatPay({
  appid: "xxxxxxxxxx",
  mchid: "xxxxxxxxxx",
  serial_no: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  authType: "WECHATPAY2-SHA256-RSA2048",
  apiclientCert: fs.readFileSync("xxx/certificate/apiclient_cert.pem"),
  apiclientkey: fs.readFileSync("xxx/certificate/apiclient_key.pem"),
  certPath: "xxx/certificate",
  APIv3: "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
});

参数说明

参数名称 参数介绍 是否必须
appid 公众号(移动应用 / 小程序)的 appid
mchid 商户号
serial_no 证书序列号
authType 请求头签名认证类型,不传则默认为 WECHATPAY2-SHA256-RSA2048
apiclientCert 公钥
apiclientkey 密钥
certPath 微信支付平台证书下载路径(需要回调解密以及验证签名则必填)【包含 wechatpay.pem 和 wechatpaySerial.txt 俩个文件】,建议与公钥密钥在一个文件夹内
APIv3 商户后台配置的 APIv3 密钥(需要回调解密以及验证签名则必填)
userAgent 微信支付平台证书下载接口请求头 user-agent(默认为 node Serve)

注意:serial_no 是证书序列号,请在商户后台查看。

获取签名值

示例代码

let signature = weChatPay.getSignature(method, url, timestamp, nonce_str, body);

参数说明

参数名称 参数介绍 是否必须
method 支付接口方法
url 支付接口地址
timestamp 时间戳
nonce_str 请求随机串
body 请求体(接口需要传则给,反之给空字符串,如"")

获取 HTTP Authorization 头

示例代码

let authorization = weChatPay.getAuthorization(nonce_str, timestamp, signature);

参数说明

参数名称 参数介绍 是否必须
nonce_str 请求随机串(需要与获取签名值的一致)
timestamp 时间戳
signature 签名值

下载微信支付平台证书

会生成 wechatpay.pem 和 wechatpaySerial.txt 俩个文件,每次更新会覆盖旧的。

微信官方建议在十二小时内更新,可以写定时任务

示例代码

let result = {};
try {
  result = await weChatPay.getWeChatPayCert();
} catch (error) {
  console.log(error);
}
console.log(result);
// { code: 200, msg: '下载证书成功' }

!!!使用此方法必须在构造实体类时传递 certPath 、 APIv3 这俩个参数 !!!

文件说明

文件名称 说明
wechatpay.pem 下载平台证书接口解密出来公钥(回调签名验证需要)
wechatpaySerial.txt 下载平台证书接口的公钥序列号(回调签名验证需要)

返回说明(为了方便开发者做对应的处理)

code data msg
200 下载成功 解释说明
500 / 其他(在 catch 里返回) 下载失败(错误信息),详细请看 msg 解释说明

支付回调签名验证

示例代码

let Body = req.body; // 微信请求你的回调接口的实体类 body
let Headers = req.headers; // 微信请求你的回调接口的 headers
let result = null;
try {
  result = await weChatPay.verifySignature(
    Headers["wechatpay-signature"], // 应答签名
    Headers["wechatpay-serial"], // 平台证书序列号
    Headers["wechatpay-timestamp"], // 生成签名的时间戳
    Headers["wechatpay-nonce"], // 应答随机串
    req.body
  );
} catch (error) {
  console.log(error);
}
console.log(result);
// { code: 200, msg: '验签名串和签名验证通过' }

!!!使用此方法必须在构造实体类时传递 certPath 、 APIv3 这俩个参数 !!!

返回说明(为了方便开发者做对应的处理)

code data msg
200 验证通过 解释说明
500 / 其他(在 catch 里返回) 验证失败(错误信息),详细请看 msg 解释说明

回调解密

建议在签名验证成功后解密

示例代码

let Body = req.body; // 微信请求你的回调接口的实体类 body
let Headers = req.headers; // 微信请求你的回调接口的 headers
let data = null;
try {
  data = await weChatPay.decrypting(
    Body.resource.ciphertext, // 结果数据密文
    Body.resource.nonce, // 加密使用的随机串
    Body.resource.associated_data // 附加数据
  );
} catch (error) {
  console.log(error);
}
console.log(data);
// { code: 200, data: xxxx(解密的数据), msg: '解密成功' }

!!!使用此方法必须在构造实体类时传递 certPath 、 APIv3 这俩个参数 !!!

返回说明(为了方便开发者做对应的处理)

code data msg
200 解密出来的数据 解释说明
500 / 其他(在 catch 里返回) 解密失败(错误信息),详细请看 msg 解释说明

weChatPay 内置方法介绍

Jsapi 下单

示例代码

let data = {
  appid: "xxxxxx",
  mchid: "xxxxxx",
  description: "测试",
  out_trade_no: "xxxxxx",
  notify_url: "xxxxxx",
  amount: {
    total: 1,
  },
  payer: {
    openid: "xxxxxx",
  },
};
let result;
try {
  result = await weChatPay.jsapiPay(data);
} catch (error) {
  console.log(error);
}
console.log(result);
// 正常返回如下示例
// {
//     "code": 200,
//     "prepay_id": "xxxxxxxxxx"
// }

参数说明

参数名称 参数介绍 是否必须
data jsapi 下单的 body 参数

详细请点击查看微信官方-jsapi-下单文档

Native 下单

示例代码

let data = {
  appid: "xxxxxx",
  mchid: "xxxxxx",
  description: "测试",
  out_trade_no: "xxxxxx",
  notify_url: "xxxxxx",
  amount: {
    total: 1,
  },
};
let result;
try {
  result = await weChatPay.nativePay(data);
} catch (error) {
  console.log(error);
}
console.log(result);
// 正常返回如下示例
// {
//     "code": 200,
//     "code_url": "xxxxxxxxxx"
// }

参数说明

参数名称 参数介绍 是否必须
data native 下单的 body 参数

详细请点击查看微信官方-native-下单文档

版本介绍

版本号 版本介绍
1.0.0 仅支持获取签名和获取头部参数 Authorization
1.0.1 在 1.0.0 的基础上增加了说明文档
1.0.2 增加了 native 支付下单函数的封装
1.0.21 增加了 jsapi 支付下单函数的封装
1.0.3 增加了微信支付平台证书下载方法、支付回调签名验证的方法、 证书(回调)解密方法的封装
最后一次编辑于  2023-12-08  
点赞 2
收藏
评论
登录 后发表内容