{% import “/cloud-function/node-sdk/macro/profit-sharing.md” as profitSharing %}

{% if apiPrefix == ‘wx’ %} {% set platformName = “微信” %}

微信支付

{% elif apiPrefix == ‘my’ %} {% set platformName = “支付宝” %}

支付宝支付

{% elif apiPrefix == ‘qq’ %} {% set platformName = “QQ “ %}

QQ 支付

{% elif apiPrefix == ‘swan’ %} {% set platformName = “百度” %}

百度支付

{% elif apiPrefix == ‘tt’ %} {% set platformName = “字节跳动” %}

字节跳动支付

{% endif %}

{% if apiPrefix == ‘swan’ %} {{apiPrefix}}.BaaS.pay(OBJECT, bannedChannels) {% elif apiPrefix == ‘wx’ %} {{apiPrefix}}.BaaS.pay(OBJECT, fn) {% else %} {{apiPrefix}}.BaaS.pay(OBJECT) {% endif %}

{% if apiPrefix == ‘swan’ %} 参数说明

参数 类型 必填 参数描述
OBJECT Object Y 订单相关信息，具体参考下面 OBJECT 参数说明
bannedChannels StringArray N 需要隐藏的支付方式

{% else %} {% endif %}

OBJECT 参数说明

{% if apiPrefix == ‘wx’ %} | 参数 | 类型 | 必填 | 参数描述 | | :——————————- | :——— | :— | :——— | | totalCost | Number | Y | 支付总额，单位：元 | | merchandiseDescription | String | Y | {{platformName}}支付凭证-商品详情的内容 | | 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。可用于订单查询

{{ profitSharing.versionWarning() }}

{% elif apiPrefix == ‘tt’ %} | 参数 | 类型 | 必填 | 参数描述 | | :——————————- | :——— | :— | :——— | | totalCost | Number | Y | 支付总额，单位：元 | | merchandiseDescription | String | Y | {{platformName}}支付凭证-商品详情的内容 | | service | String | N | 支付方法，默认为「收银台支付」，wechat 为直接使用「微信支付」，alipay 为直接使用「支付宝支付」 | | merchandiseSchemaID | Integer | N | 商品数据表 ID，可用于定位用户购买的物品 | | merchandiseRecordID | String | N | 商品数据行 ID，可用于定位用户购买的物品 | | merchandiseSnapshot | Object | N | 根据业务需求自定义的数据 | {% else %} | 参数 | 类型 | 必填 | 参数描述 | | :——————————- | :——— | :— | :——— | | totalCost | Number | Y | 支付总额，单位：元 | | merchandiseDescription | String | Y | {{platformName}}支付凭证-商品详情的内容 | | merchandiseSchemaID | Integer | N | 商品数据表 ID，可用于定位用户购买的物品 | | merchandiseRecordID | String | N | 商品数据行 ID，可用于定位用户购买的物品 | | merchandiseSnapshot | Object | N | 根据业务需求自定义的数据 | {% endif %}

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

{% if apiPrefix == ‘swan’ %} bannedChannels 参数说明

channel 说明
Alipay 支付宝
BDWallet 百度钱包
Wechat 微信支付

{% else %} {% endif %}

支付成功返回参数说明

{% if apiPrefix == ‘wx’ or apiPrefix == ‘qq’ %} | 参数 | 类型 | 说明 | | :————————————-| :——- | :— | | errMsg | String | {{platformName}}支付状态信息 | | transaction_no | String | {{platformName}}支付流水号 | | trade_no | String | {{platformName}}支付交易 ID, 业务方在{{platformName}}后台对账时可看到此字段 | {% elif apiPrefix == ‘my’ %} | 参数 | 类型 | 说明 | | :————————————-| :——- | :— | | resultCode | String | 支付宝支付状态码 | | transaction_no | String | 支付宝支付流水号 | | trade_no | String | 支付宝支付交易 ID, 业务方在支付宝后台对账时可看到此字段 |

info resultCode是支付宝返回的状态码， resultCode: '9000' 为支付成功，resultCode: '8000' 为正在处理中， 具体以知晓云后台支付订单的状态为准。请参考订单查询接口文档。 {% elif apiPrefix == ‘swan’ or apiPrefix == ‘tt’ %} | 参数 | 类型 | 说明 | | :————————————-| :——- | :— | | transaction_no | String | {{platformName}}支付流水号 | {% endif %}

示例代码

{% if apiPrefix == ‘wx’ %}

  1. // 支付示例代码
  2. let params = {
  3.   totalCost: 0.1,
  4.   merchandiseDescription: '深蓝色秋裤'
  5. }
  7. // 可在用户点击支付完成前在 order 中拿到 transaction_no 和 trade_no
  8. const cb = order => console.log(order)
  10. wx.BaaS.pay(params, cb).then(res => {
  11.   // success. 支付请求成功响应，可以在 res 中拿到 transaction_no 和支付结果信息
  12. }, err => {
  13.   // 未完成用户授权或发生网络异常等
  14.   console.log(err)
  15. })

{% else %}

  1. // 支付示例代码
  2. let params = {
  3.   totalCost: 0.1,
  4.   merchandiseDescription: '深蓝色秋裤'
  5. }
  7. {{apiPrefix}}.BaaS.pay(params).then(res => {
  8.   // success. 支付请求成功响应，可以在 res 中拿到 transaction_no 和支付结果信息
  9. }, err => {
  10.   // 未完成用户授权或发生网络异常等
  11.   console.log(err)
  12. })

{% endif %}

支付成功返回示例

{% if apiPrefix == ‘wx’ or apiPrefix == ‘qq’ %}

  1. {
  2.   errMsg: "requestPayment:ok",
  3.   transaction_no: "MDUhtNmacdYBKokJbCXhvYuoJnHXzpeN",
  4.   trade_no: '4DySOWgNssfu5XsiTH9Ek2f5m9jWTwTw'
  5. }

{% elif apiPrefix == ‘my’ %}

  1. {
  2.   resultCode: '9000',
  3.   transaction_no: 'Q6lgbKPmNlGXKbfcHGuWiT0KeksLSZvC',
  4.   trade_no: '4DySOWgNssfu5XsiTH9Ek2f5m9jWTwTw'
  5. }

{% elif apiPrefix == ‘swan’ or apiPrefix == ‘tt’ %}

  1. {
  2.   transaction_no: "MDUhtNmacdYBKokJbCXhvYuoJnHXzpeN",
  3. }

{% endif %}

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

{% if apiPrefix == ‘wx’ %}

  1. wx.BaaS.pay(params).then(res => {
  2.   // success. 支付请求成功响应。
  3. }, err => {
  4.   // HError 对象
  5.   if (err.code === 603) {
  6.     console.log('用户尚未授权')
  7.   } else if (err.code === 607) {
  8.     console.log('用户取消支付')
  9.   } else if (err.code === 608){
  10.     console.log(err.message)
  11.   }
  12. })

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

接口说明

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

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

{% elif apiPrefix == ‘my’ %}

  1. my.BaaS.pay(params).then(res => {
  2.   // success. 支付请求成功响应。
  3. }, err => {
  4.   // PayError 对象
  5.   console.log(err.code, err.message)
  6. })

PayError 对象结构请参考 PayError 错误码详解

接口说明

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

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

PayError 错误码详解（仅支付宝）

支付错误状态码与支付宝小程序支付接口的状态码一致。

错误码对应的错误信息如下：

'4000' 订单支付失败

'6001' 用户中途取消

'6002' 网络连接出错

'6004' 支付结果未知（有可能已经支付成功），请查询商户订单列表中订单的支付状态

'99' 用户点击忘记密码导致快捷界面退出（only iOS）

{% elif apiPrefix == ‘qq’ %}

  1. qq.BaaS.pay(params).then(res => {
  2.   // success. 支付请求成功响应。
  3. }, err => {
  4.   // HError 对象
  5.   if (err.code === 603) {
  6.     console.log('用户尚未授权')
  7.   } else if (err.code === 607) {
  8.     console.log('用户取消支付')
  9.   } else if (err.code === 608){
  10.     console.log(err.message)
  11.   }
  12. })

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

接口说明

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

{% elif apiPrefix == ‘swan’ %}

  1. swan.BaaS.pay(params).then(res => {
  2.   // success. 支付请求成功响应。
  3. }, err => {
  4.   // HError 对象
  5.   if (err.code === 608) {
  6.     console.log(err.message)
  7.   }
  8. })

{% elif apiPrefix == ‘tt’ %}

  1. tt.BaaS.pay(params).then(res => {
  2.   // success. 支付请求成功响应。
  3. }, err => {
  4.   // HError 对象
  5.   if (err.code === 608) {
  6.     console.log(err.message)
  7.   }
  8. })

{% endif %}