更新记录

1.0.0（2020-12-15） 下载此版本

1.0.0 发布。

平台兼容性

云函数类插件通用教程

使用云函数类插件的前提是：使用HBuilderX 2.9+

EXPLAIN-WEIXIN

explain扩展模块，微信公众号开发工具包，包含微信公众号网页授权、统一下单支付、订单退款、订单查询等。

加入QQ群：970799055。

若从插件市场直接部署后报错，在本地重新上传部署一次即可。

模块依赖

需要安装依赖：

配置说明

模块方法

authorize 网页授权

getAuthorizeUrl(options)

获取微信授权地址

使用示例

const explain = require("explain");
explain.weixin = require("explain-weixin");

let url = explain.weixin.authorize.getAuthorizeUrl({
    redirect_uri: "http%3A%2F%2Fnba.bluewebgame.com%2Foauth_response.php"
});
// url为https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxf0e81c3bee622d60&redirect_uri=http%3A%2F%2Fnba.bluewebgame.com%2Foauth_response.php&response_type=code&scope=snsapi_userinfo&state=1#wechat_redirect

getAccessToken(options)

通过code换取网页授权access_token。 请注意，这里通过code换取的是一个特殊的网页授权access_token,与基础支持中的access_token（该access_token用于调用其他接口）不同。

使用示例

const explain = require("explain");
explain.weixin = require("explain-weixin");

let accessToken = await explain.weixin.authorize.getAccessToken({
    code: "CODE"
});
/**
 * accessToken为
 * {
 *   "access_token": "ACCESS_TOKEN",
 *   "expires_in": 7200,
 *   "refresh_token": "REFRESH_TOKEN",
 *   "openid": "OPENID",
 *   "scope": "SCOPE" 
 * }
 */

getUserInfo(options)

拉取用户信息（需scope为 snsapi_userinfo）

使用示例

const explain = require("explain");
explain.weixin = require("explain-weixin");

let accessToken = await explain.weixin.authorize.getAccessToken({
    code: "CODE"
});
let userInfo = await explain.weixin.authorize.getUserInfo({
    access_token: accessToken.access_token,
    openid: accessToken.openid
});
/**
 * userInfo为
 * {
 *   "openid": "OPENID",
 *   "nickname": "NICKNAME",
 *   "sex": "1",
 *   "province": "PROVINCE",
 *   "city": "CITY",
 *   "country": "COUNTRY",
 *   "headimgurl": "https://thirdwx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/46",
 *   "privilege": ["PRIVILEGE1" "PRIVILEGE2"],
 *   "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL" 
 * }
 */

refreshAccessToken(options)

刷新access_token（如果需要）

checkAccessToken(options)

检验授权凭证（access_token）是否有效

pay 支付

unifiedorder(options)

统一下单

参数与官方文档一致，官方文档地址：统一下单 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_1

使用示例

const explain = require("explain");
explain.weixin = require("explain-weixin");

let res = await explain.weixin.pay.unifiedorder({
    body: `测试订单-4200000001202012152100111`,
    out_trade_no: "4200000001202012152100111",
    total_fee: 100,
    trade_type: "JSAPI",
    openid: "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o"
});
/**
 * res为
 * {
 *    "return_code": "SUCCESS",
 *    "return_msg": "OK",
 *    "appid": "wx2421b1c4370ec43b",
 *    "mch_id": "10000100"
 *    "nonce_str": "IITRi8Iabbblz1Jc",
 *    "openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
 *    "sign": "7921E432F65EB8ED0CE9755F0E86D72F",
 *    "result_code": "SUCCESS",
 *    "prepay_id": "wx201411101639507cbf6ffd8b0779950874",
 *    "trade_type": "JSAPI"
 * }
 */

orderquery(options)

查询订单

参数与官方文档一致，官方文档地址：查询订单 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_2

closeorder(options)

关闭订单

参数与官方文档一致，官方文档地址：关闭订单 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_3

refund(options)

申请退款

参数与官方文档一致，官方文档地址：申请退款 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_4

refundquery(options)

查询退款

参数与官方文档一致，官方文档地址：查询退款 https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=9_5