这可能是用来开发微信支付APIv3的NodeJS SDK中最好的一个

微信支付 文章 2020-06-19 13:18 0 96 全屏看文

原文作者是微信官方推荐的php SDK(https://github.com/wechatpay-apiv3)作者。不得不说这货很闲,在成熟的思维基础上又推出了nodejs版。而且很荣幸,他是我同事。

如下是他对nodejs版本的介绍:

微信支付官方提供了两个包,一个是Java版的,另一个是PHP版的。继上一篇无侵入地向官方PHP版提供了媒体文件上传功能之后,我就在想,NodeJS都已经到14.4版本了,应该有一个流行的js版的开发包吧。搜了一圈儿,发现几乎没有,遂动手花了大约两周闲暇时间,完整实现了微信支付APIv3的几乎所有功能,特别地对账单下载及处理,也算是填补并加强了官方包暂未实现的功能之一吧。有了这些成熟开发包的覆盖,包括官方包在内,现在是时候全面切换至微信支付APIv3版了。

项目以MIT许可证开源,使用请保留许可证说明。

Axios拦截器项目构造函数

主要功能

1. 使用Node原生代码实现微信支付APIv3的AES加/解密功能(aes-256-gcm with aad)

2. 使用Node原生代码实现微信支付APIv3的RSA加/解密、签名、验签功能(sha256WithRSAEncryption with RSA_PKCS1_OAEP_PADDING)

3. 大部分微信支付APIv3的HTTP GET/POST应该能够正常工作,依赖 Axios

4. 支持微信支付APIv3的媒体文件上传(图片/视频)功能,可选依赖 form-data

5. 支持微信支付APIv3的应答证书下载功能,依赖 commander, 使用手册如下

6. 支持微信支付APIv3的帐单下载及解析功能

安装

$ npm install wechatpay-axios-plugin

系统要求

NodeJS的原生crypto模块,自v12.9.0在 publicEncrypt 及 privateDecrypt 增加了 oaepHash 入参选项,本项目显式声明入参,本人不确定其在v12.9.0以下是否正常工作。所以Node的最低版本要求应该是v12.9.0.

万里长征第一步

微信支付APIv3使用了许多成熟且牛逼的接口设计(RESTful API with JSON over HTTP),数据交换使用非对称(RSA)加/解密方案,对上行数据要求(RSA)签名,对下行数据要求(RSA)验签。API上行所需的商户RSA私钥证书,可以由商户的超级管理员微信支付商户平台生成并获取到,然而,API下行所需的平台RSA公共证书只能从 /v3/certificates 接口获取(应答证书还经过了AES对称加密,得用 APIv3密钥才能解密)。本项目也提供了命令行下载工具,使用手册如下:

$ ./bin/certificateDownloader -h

命令行工具帮助文档

注:像其他通用命令行工具一样,-h --help 均会打印出帮助手册,说明档里的 指 必选参数,类型是字符串; [string] 指 可选字符串参数,默认值是 /temp(系统默认临时目录)

$ ./bin/certificateDownloader -m NUMERICAL -s HEXADECIAL -f apiclient_key.pem -k YOURAPIV3SECRETKEY -o .

命令行工具执行结果

注:提供必选参数且运行后,屏幕即打印出如上信息,提示证书序列号起、止格林威治(GMT)时间以及证书下载保存位置。

接口通讯要用 商户RSA私钥证书 签名及平台RSA公共证书验签,只有获取到了平台RSA公共证书,后续的其他接口才能正常应答验签,所谓“万里长征第一步”就在这里。本下载工具也无例外对应答内容,做了验签处理,技法“剑(qí)走(zhāo)偏(yín)锋(jì)“而已,即:用Axios的拦截器把下载的证书(AES解密)处理完后,立即用于验签。

得到证书之后,开发者需要把所得serial及wechatpay_HEXADECIALHEXADECIALHEXADECIAL.pem(文件流或者文本内容)组成 对,key为证书序列号,value为证书内容,传入项目构造函数的certs字段里。 其他接口使用就基本上没有啥问题了。

文档及示例在github及npm上README都有,也都是基本用法,没啥花活儿,祝开心。

最后附上文章地址:https://page.om.qq.com/page/OjTk-GbMjnXjBb3cKEeGqV4A0?source=omapp


-EOF-