微信支付

wx.BaaS.pay(OBJECT, fn)

OBJECT 参数说明

参数 类型 必填 参数描述
totalCost Number Y 支付总额，单位：元
merchandiseDescription String Y 微信支付凭证-商品详情的内容
merchandiseSchemaID Integer N 商品数据表 ID，可用于定位用户购买的物品
merchandiseRecordID String N 商品数据行 ID，可用于定位用户购买的物品
merchandiseSnapshot Object N 根据业务需求自定义的数据
profitSharing Boolean N 当前订单是否需要分账。分账操作，请查看微信直连商户分账

fn 参数说明（3.21.5 及以上版本支持）

参数 类型 必填 参数描述
fn Function N 调用该函数可提前获取订单信息如 trade_no, transaction_no。可用于订单查询

分账功能仅商用版及商用版以上版本可以使用。

举例：开发者有一个 Article 表, 里面有免费 / 付费的文章, 当用户对一篇付费文章进行支付时, 则可以将 Article 表的 ID 作为 merchandiseSchemaID, 文章记录的 ID 作为你 merchandiseRecordID 传入到 wx.BaaS.pay(object) 写进支付订单记录。当用户阅读此付费文章时, 则可以通过 merchandiseSchemaID, merchandiseRecordID 来查询用户是否付费。

支付成功返回参数说明

参数 类型 说明
errMsg String 微信支付状态信息
transaction_no String 微信支付流水号
trade_no String 微信支付交易 ID, 业务方在微信后台对账时可看到此字段

示例代码

// 支付示例代码
let params = {
  totalCost: 0.1,
  merchandiseDescription: '深蓝色秋裤'
}

// 可在用户点击支付完成前在 order 中拿到 transaction_no 和 trade_no
const cb = order => console.log(order)

wx.BaaS.pay(params, cb).then(res => {
  // success. 支付请求成功响应，可以在 res 中拿到 transaction_no 和支付结果信息
}, err => {
  // 未完成用户授权或发生网络异常等
  console.log(err)
})

支付成功返回示例

{
  errMsg: "requestPayment:ok",
  transaction_no: "MDUhtNmacdYBKokJbCXhvYuoJnHXzpeN",
  trade_no: '4DySOWgNssfu5XsiTH9Ek2f5m9jWTwTw'
}

为了方便开发者清楚区分用户取消支付还是支付失败，我们为其增加了错误类型，你可以通过像以下操作，对支付状态进行判断：

wx.BaaS.pay(params).then(res => {
  // success. 支付请求成功响应。
}, err => {
  // HError 对象
  if (err.code === 603) {
    console.log('用户尚未授权')
  } else if (err.code === 607) {
    console.log('用户取消支付')
  } else if (err.code === 608){
    console.log(err.message)
  }
})

HError 对象结构请参考错误码和 HError 对象

接口说明

小程序支付模式图-来自微信官方

wx.BaaS.pay(object) 实际上做了发起支付统一下单请求，及调用 wx.requestPayment() 接口等操作。开发者只需要调用 wx.BaaS.pay(object) , 传入必填参数即可发起微信支付。用户感知到的现象就是, 点击付款按钮，弹出支付弹框, 要求用户输入密码, 用户输入正确的密码后完成支付流程, 停在支付结果页。用户可在支付结果页点击返回商家按钮回到支付前界面。

results matching ""

    powered by

    No results matching ""