koa3-wechat
Version:
wechat api modified by windsome.feng
126 lines (107 loc) • 4.69 kB
Markdown
koa3-wechat [](http://badge.fury.io/js/koa3-wechat) [](https://travis-ci.org/windsome/koa3-wechat) [](https://david-dm.org/windsome/koa3-wechat) [](https://coveralls.io/r/windsome/koa3-wechat)
======
微信公众平台消息接口服务中间件与API SDK
```sh
npm install koa3-wechat
```
+ 微信用户消息和事件推送处理功能（即接受URL转发的消息），开发者可在 开发->基本设置->修改配置->URL(服务器地址) 设置。
- 对应于wechat.js
- 自动回复（文本、图片、语音、视频、音乐、图文）
- 会话支持（创新功能）
+ 微信支付API支持
- 对应wepay.js
- 普通商户
- 境内服务商版本（包含特约商户）
+ 微信公众号API支持
- oauth.js 支持oauth2网页认证
- jssdk.js 支持jssdk开发
- user.js 用户管理接口
- qrcode.js 获取永久及临时二维码
- template.js 模板消息支持
- media.js 多媒体接口
- menu.js 自定义菜单
+ 具体微信公众平台功能清单详见 [公众平台api完成进度](./doc/api_mp.md)
+ 具体微信支付功能清单详见 [微信支付api完成进度](./doc/api_payment.md)
详见 [wechat.js用法](./doc/usage_wechat.md)
```
// 服务商下特约商户的参数
let config = {
appId: 'wxc...................', //服务商APPID，邮件中
mchId: '14........',
notifyUrl: 'http://<你的域名>/apis/pay_notify', // 设置到微信支付后台
partnerKey: '1234567890abcdefghijklmnopqrstuv', // 设置成你自己的key，在pay.weixin.qq.com设置
subAppId: 'wxf...............',
subMchId: '14........',
pfx: fs.readFileSync(__dirname + '/apiclient_cert_14.........p12'),
passphrase: '14........'
}
// 普通商户的参数
let config = {
appId: 'wx7...................', //服务商APPID，邮件中
mchId: '14........',
notifyUrl: 'http://<你的域名>/apis/pay_notify', // 设置到微信支付后台
partnerKey: '1234567890abcdefghijklmnopqrstuv', // 设置成你自己的key，在pay.weixin.qq.com设置
pfx: fs.readFileSync(__dirname + '/apiclient_cert_14.........p12'),
passphrase: '14........'
},
// 初始化
let wepay = new WechatPay(config);
// 获取订单的预支付信息
var trade = {
body: '描述信息', //最长127字节
attach: '附加信息', //最长127字节
out_trade_no: '<订单ID，一般用订单表的唯一ID或UUID>', //
total_fee: '<订单总价>', //以分为单位，货币的最小金额
trade_type: 'JSAPI',
spbill_create_ip: '<发起支付的IP>', //ctx.request.ip
};
if (config.subMchId) {
// 特约商户, 传入sub_openid
trade = { ...trade, sub_openid: openid };
} else {
// 普通商户，传入openid
trade = { ...trade, openid };
}
var params = await wepay.getBrandWCPayRequestParams(trade);
if (!params || !(params.package && params.paySign)) {
console.log('error! getBrandWCPayRequestParams() return null!');
}
// 支付成功后会有notify
// see <https://github.com/windsome/windpress/blob/1619f7ec01e2cb1e85857702d381304e79713e53/server/wechat/index.js#L269>
// 退款
var retobj = await wepay.refund({ out_trade_no });
```
1. 艺术品挖宝 <http://mp.zdili.com> , 公众号演示，搜索 "帝利文化"
2. nbiot物联网+微信公众号+微信支付 ，公众号演示，搜索 "飞觉网络"
1. windpress是一个简单的一元夺宝项目，其中有微信api使用方法
项目源码 <https://github.com/windsome/windpress>
2. 即将上线，一个nbiot的项目，用户通过微信扫码某个nbiot设备进入页面支付，支付完成启动设备。
原始API文档请参见：[消息接口指南](http://mp.weixin.qq.com/wiki/index.php?title=消息接口指南)。
微信开发QQ群： 573207886
<img src="./219668615.jpg" width="200" alt="捐赠" align=center />
The MIT license.
1. 2018.9.19增加了backend支持,允许在微服务情况下配置后端缓存.目前允许`memory`和`redis`,默认为`memory`模式.
```
配置方法为参数中加入了
opts = {
appId,
appSecret,
backend: {
type, // memory, redis.
url // redis url
}
}
```