微信接口

前端接口

$wx.getUser(openid)

从微信服务器获取最新的用户数据，即存在user表wx里数据。

$wx.sendText(openid, txt)

发送文本消息。支持链接与换行
$wx.sendText('人气大赛\n\n→<a href="http://www.zc-yun.com">点击进入投票页面</a>←\n↑↑↑↑↑\n点击上方蓝字')

$wx.sendNews(openid, article)

发送图文信息。图文是{ title, description, url, picurl }格式的对象

$wx.sendTemplate(openid, url, template_id, data)

发送模板消息。templateId是从微信公众号申请到的模板ID

$wx.createTmpQRCode(scene, expire)

创建临时二维码。失效时间expire以秒为单位，默认30秒，最大不超过2592000（30天）。可得$r：{ url, ticket, expire_seconds }。

$wx.createLimitQRCode(scene)

创建永久二维码。无过期时间，数量较少(最多10万个)。适用于帐号绑定、用户来源统计等场景

带场景值二维码

上面两个都属于带场景值二维码，场景值scene最长64。把返回的$r.url生成二维码（比如用二维码生成插件），用户扫描时，微信会将带场景值推送给服务器（即微信公众号配置讲述的启用服务器配置），如果用户还未关注公众号则会先引导关注，开发者根据不同的场景值做出不同的处理。
使用场景：统计不同渠道的关注量，回复不同的内容（可多条）

$wx.syncOrder(id)

传入订单id，同步微信支付的订单状态并返回订单详情。支付详情存在订单z字段下，付款成功确认后的状态z.trade_state应该是SUCCESS。

$wx.syncRefund(out_refund_no)

传入退款单号，同步微信支付的退款状态并返回订单详情。退款详情存在订单z.refund数组下，退款成功确认后的状态z.refund[0].status应该是SUCCESS。

$wx.downloadBill(date)

下载账单，包括资金账单（fundflowbill）和交易账单（tradebill）
downloadBill("2024-06-13")

注：上面的都可在桌面端使用，下面的只在微信端可用

$wx.openAddress()

打开”我的地址“，用户授权并选择一个地址后可得$r：{ userName, postalCode, provinceName, cityName, countryName, detailInfo, nationalCode, telNumber }

$wx.scanQR()

调起微信扫一扫。可得$r：{ resultStr, errMsg }

$wx.getLoc()

获取地理位置。用户授权后可得$r：{ longitude: 经度, latitude: 纬度, accuracy: 精度, speed: 速度 }

$wx.openLoc(longitude, latitude, name, address, infoUrl, scale)

打开微信地图。longitude：浮点数，范围180 ~ -180；latitude：浮点数，范围90 ~ -90；infoUrl：在查看位置界面底部显示的超链接，可点击跳转；scale：整形，范围1 ~ 28，默认15。

$wx.previewImage()

微信全屏预览图片。平台在微信上的每个页面都调用了一次此接口，所以通常不用自己调用。但如果有些图片一开始不显示，只有符合特定渲染条件时才显示，当渲染条件变化时就需要调用一次此接口。

$wx.pay(order, onError, onConfirm)

唤起微信支付/统一下单。参数order可以是待支付订单的id；如订单还未创建，也可以是至少包含如下信息的对象，平台会自动以此创建好订单后马上唤起支付

{ 
    type: String,  // 订单分类 自定义字符串
    desc: String,  // 订单描述 自定义字符串
    price: Number, // 单价
    count: Number, // 数量
}

支付请求成功执行后（付款并未确认）将返回支付详情后继续执行后续表达式（下一行），状态通常是PROCESSING（退款处理中），需要一段时间付款才能得到确认。
如果支付失败将执行onError表达式（前端执行）并终止执行后续表达式。
可以传入付款确认回调表达式onConfirm，即微信支付确认付款到账后执行的表达式，在服务器端执行，执行上下文是订单详情。

后端接口

$wx.sendText(openid, txt)

$wx.sendNews(openid, article)

$wx.sendTemplate(openid, url, template_id, data)

$wx.syncOrder(id, onConfirm)

$wx.refund(id, sum, reason, onConfirm)

申请退款，传入原订单id，退款金额，退款缘由。接口成功执行后（并未确认）将返回退款详情，通常状态是PROCESSING（退款处理中）。需要一段时间退款才能得到确认。零钱支付的退款5分钟内到账，银行卡支付的退款1-3个工作日到账
可以传入退款确认回调表达式onConfirm，即微信支付退款确认到账后执行的表达式，执行上下文是订单详情。

$wx.syncRefund(out_refund_no)

事件响应接口

$wx.onMsg()
收到公众号消息时触发，执行上下文：{ openid, msgType, content }

$wx.onScan()
扫码时触发，执行上下文：{ openid, scene }

$wx.onSubscribe()
关注公众号时触发，执行上下文：{ wx: { openid } }。可以乘此机会给用户发送最新咨询或优惠活动信息。

$wx.onQRlogin()
用户微信扫码登录PC端时触发，执行上下文是用户对象。
如果用户未注册会自动创建用户，但此时用户没有nickname和headimgurl，推荐发送链接引导用户在微信端授权登录以获取昵称和头像：$wx.sendText(wx.openid, wx.nickname ? '已登录电脑端' : '<a href="http://www.zcappp.cn/me">点击登录电脑端</a>')

$wx.onQRbind()
用户在PC端扫码绑定微信时触发，执行上下文：{ exist: 用户对象, wx: { openid } }
如果当前用户的openid已经绑定了某个账号，则会把此账号信息放在执行环境的exist里：$wx.sendText(wx.openid, exist ? '你当前微信已经绑定了另一个账号(' + exist._id + '), 不可绑定多个账号' : '微信已绑定')