# wx.checkIsSupportMidasPayment(Object object)
基础库 3.10.3 开始支持,低版本需做兼容处理。
以 Promise 风格 调用:不支持
微信 Windows 版:支持
微信 Mac 版:支持
微信 鸿蒙 OS 版:支持
# 功能描述
检查当前环境是否支持虚拟支付。使用前请注意阅读相关说明。
# 参数
# Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
# object.success 回调函数
# 参数
# Object res
| 属性 | 类型 | 说明 | |||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| errMsg | String | 调用结果信息,格式为 "checkIsSupportMidasPayment:ok" | |||||||||||||||||
| data | Object | 支付支持信息对象 | |||||||||||||||||
| |||||||||||||||||||
# object.fail 回调函数
# 参数
# Object err
| 属性 | 类型 | 说明 |
|---|---|---|
| errMsg | String | 错误信息 |
# 平台支持说明
- Android、Windows、OHOS 平台:默认支持虚拟支付,接口直接返回支持
- iOS 平台:需满足以下环境要求才可能支持虚拟支付
- 操作系统要求:使用 iPhone 或者 iPad,iOS 15 及以上版本
- 基础库版本要求:3.10.3 及以上
- 客户端版本要求:8.0.68 及以上
- 苹果支付不支持使用沙箱环境,仅支持使用现网环境
# 注意事项
若该 API 都不存在,则 iOS 一定不支持虚拟支付,请保持旧版本逻辑。
# 示例代码
if (wx.checkIsSupportMidasPayment) {
wx.checkIsSupportMidasPayment({
success(res) {
console.log('支持检查结果:', res)
if (res.data.allow_pay) {
console.log('当前环境支持支付')
// 可以继续调用支付相关接口
} else {
console.log('当前环境不支持支付')
// 请自行适配用户提示文案
}
},
fail(err) {
console.error('检查支持情况失败:', err)
},
complete() {
console.log('检查完成')
}
})
}