wx.requestOrderPayment(Object args)

基础库 2.16.0 开始支持,低版本需做兼容处理

Promise 风格 调用:支持

小程序插件:不支持

创建自定义版交易组件订单,并发起支付。 仅接入了自定义版交易组件的小程序需要使用,普通小程序可直接使用 wx.requestPayment

参数

Object args

属性 类型 默认值 必填 说明
timeStamp string 时间戳,从 1970 年 1 月 1 日 00:00:00 至今的秒数,即当前的时间
nonceStr string 随机字符串,长度为32个字符以下
package string 统一下单接口返回的 prepay_id 参数值,提交格式如:prepay_id=***
paySign string 签名,具体见微信支付文档
orderInfo Object 订单信息,仅在需要校验的场景下需要传递,具体见接口说明
extUserUin string 外部APP用户ID
signType string MD5 签名算法,应与后台下单时的值一致
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)

args.signType 的合法值

说明 最低版本
MD5 仅在 v2 版本接口适用
HMAC-SHA256 仅在 v2 版本接口适用
RSA 仅在 v3 版本接口适用

示例代码


// 除 orderInfo 以外,其余字段与 wx.requestPayment 一致
wx.requestOrderPayment({
  orderInfo: {},
  timeStamp: '',
  nonceStr: '',
  package: '',
  signType: 'MD5',
  paySign: '',
  success (res) { },
  fail (res) { }
})

前置检查

接入自定义版交易组件之后,若要发起微信支付,请先查询需要校验的场景。 在需要校验的场景中,发起微信支付时,必须使用该接口,需要按照要求传入相关的订单信息进行校验,校验通过后用户才可以完成当前订单的支付,非需要校验的场景则可以按照商家要求自行选择传入订单信息或不传入。