ape-node-wechatpay-v3 v1.0.31

ape-node-wechatpay-v3

目录

安装

• npm

用法介绍

• 创建 weChatPay 实例

• 获取签名值

• 获取 HTTP Authorization 头

• 获取 jsapi 客户端签名值

• 下载微信支付平台证书

• 支付回调签名验证

• 证书、回调解密

内置方法介绍

• Jsapi 下单

• Native 下单

版本介绍

安装

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",
});

参数说明

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

获取签名值

示例代码

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

参数说明

获取 HTTP Authorization 头

示例代码

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

参数说明

获取 jsapi 客户端签名值

示例代码

let paySign = this.getJsapiSignature(appid, timeStamp, nonceStr, package);

参数说明

下载微信支付平台证书

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

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

示例代码

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

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

文件说明

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

支付回调签名验证

示例代码

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 这俩个参数 ！！！

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

回调解密

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

示例代码

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 这俩个参数 ！！！

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

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);
// 正常返回如下示例(data中包含jsapi支付客户端（小程序或者网页）所需要的全部参数)
// {
//   code: 200,
//   data: {
//     appid: 'xxxxxx',
//     timeStamp: 'xxxxxx',
//     nonceStr: 'xxxxxx',
//     package: 'prepay_id=xxxxxx',
//     signType: 'RSA',
//     paySign: 'xxxxxx'
//   },
//   msg: 'success'
// }

参数说明

详细请点击查看微信官方-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"
// }

参数说明

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

版本介绍