# 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 | 是 | 签名,具体见微信支付文档 | ||||||||||
signType | string | MD5 | 否 | 签名算法,应与后台下单时的值一致 | |||||||||
| |||||||||||||
success | function | 否 | 接口调用成功的回调函数 | ||||||||||
fail | function | 否 | 接口调用失败的回调函数 | ||||||||||
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# 示例代码
// 除 orderInfo 以外,其余字段与 wx.requestPayment 一致
wx.requestOrderPayment({
orderInfo: {},
timeStamp: '',
nonceStr: '',
package: '',
signType: 'MD5',
paySign: '',
success (res) { },
fail (res) { }
})
# 前置检查
接入自定义版交易组件之后,若要发起微信支付,请先查询需要校验的场景。 在需要校验的场景中,发起微信支付时,必须使用该接口,需要按照要求传入相关的订单信息进行校验,校验通过后用户才可以完成当前订单的支付,非需要校验的场景则可以按照商家要求自行选择传入订单信息或不传入。