更新记录

1.18.1(2026-10-30)

  • 【优化】uni-app x 蒸汽模式示例页面
  • 最新文档 传送门

1.18.0(2026-10-30)

  • 【重要】支持 uni-app x 蒸汽模式(需 HBuilderX ≧ 5.33)
  • 【重要】恢复 "runtime": "Nodejs18" 配置,注意:此配置不兼容 HBuilderX 5.15 版本,请尽快升级到 HBuilderX 最新版
  • 【修复】当设置 alipayAppPayToH5Pay: true(使用当面付接口来代替支付宝app支付)时,部分情况下可能无法唤起支付宝的问题
  • 【修复】Android 等移动设备可能被识别为电脑,导致进入 PC 扫码支付的问题
  • 【修复】退款金额传入 0、空字符串等无效值时可能误触发全额退款的问题;不传仍按全额退款处理
  • 最新文档 传送门

1.17.0(2026-06-03)

  • 【重要】新增微信商家转账 - 免确认收款授权功能,支持用户授权一次后,之后转账无需用户确认收款 传送门
  • 【新增】createUserConfirmAuthorization 接口,发起免确认收款授权 传送门
  • 【新增】closeUserConfirmAuthorization 接口,解除免确认收款授权 传送门
  • 【新增】queryUserConfirmAuthorization 接口,查询免确认收款授权结果 传送门
  • 【新增】transfer 接口新增 out_authorization_no、authorization_id 参数,支持通过授权单号发起免确认收款转账 传送门
  • 【新增】新增免确认收款授权异步回调通知处理(transfer-auth-notify)传送门
  • 【优化】当输入 user_name 参数时,强制校验用户姓名是否一致(之前版本仅金额大于2000元时才会校验)
  • 最新文档 传送门
查看更多

平台兼容性

云端兼容性

支付宝云 腾讯云 阿里云
√ √ √

uni-app(4.36)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
√ √ √ √ √ × √ √ √
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
√ √ √ × × × √ × × - - -

uni-app x(5.33)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
√ √ √ √

插件名称:vk-uni-pay

作者:VK

什么是 vk-uni-pay?

vk-uni-pay 是基于 unicloud 量身定制的支付插件,兼容任何 unicloud 框架。

2021-07-06 vk-uni-pay 万能支付插件 正式上线

与官方 uni-pay 的关系?

vk-uni-pay 依赖 uni-pay 的公共模块,同时在原 uni-pay 基础上进行拓展,具有超高自由度。

同时支持 uni-app 和 uni-app x 蒸汽模式

本插件同时支持 uni-app 和 uni-app x 蒸汽模式

注意:目前支持情况

表中 uni-app x 指 HBuilderX 5.31+ 的蒸汽模式;仅标注 uni-app 的项目,表示本插件暂不支持在 uni-app x 中使用。

支付方式 支持的 uniapp 版本 说明 开通对应支付产品
H5 手机-支付宝支付 uni-app、uni-app x 在 H5 浏览器中唤起支付宝客户端支付 支付宝当面付
H5 手机-微信支付 uni-app、uni-app x 在 H5 浏览器中唤起微信客户端支付 微信 H5 支付
PC 扫码支付-支付宝支付 uni-app、uni-app x 在 PC 浏览器中出现支付二维码,通过支付宝扫码支付 支付宝当面付
PC 扫码支付-微信支付 uni-app、uni-app x 在 PC 浏览器中出现支付二维码,通过微信扫码支付 微信 Native 支付
微信小程序支付 uni-app、uni-app x 在微信小程序中支付 微信小程序支付
支付宝小程序支付 uni-app、uni-app x 在支付宝小程序中支付 支付宝 JSAPI 支付
APP-支付宝转 H5 支付 uni-app、uni-app x 可以免申请 APP 接口,效果等于 APP 支付接口,但无法自动返回 APP 支付宝当面付
APP-支付宝支付 uni-app、uni-app x 在 APP 中唤起支付宝客户端支付,支付成功后自动返回到 APP 页面 支付宝 APP 支付
APP-微信支付 uni-app、uni-app x 在 APP 中唤起微信客户端支付,支付成功后自动返回到 APP 页面 微信 APP 支付
公众号 H5-微信支付 uni-app、uni-app x 在微信公众号的 H5 页面中唤起微信客户端支付 微信 JSAPI 支付
转账到支付宝余额 uni-app、uni-app x 一般用于给用户提现等业务场景(秒到) 转账到支付宝账户
转账到微信零钱 uni-app、uni-app x 一般用于给用户提现等业务场景(秒到) 商家转账
强制使用二维码支付 uni-app、uni-app x 强制使用二维码支付,让顾客扫码支付,一般用于物联网,如按摩椅上的扫码支付 支付宝当面付、微信 Native 支付
从数据库中读取商户配置(多商户) uni-app、uni-app x 一般用于多商户时使用(非服务商模式) -
服务商模式(多商户) uni-app、uni-app x 一般用于多商户时使用(服务商模式) -
微信小程序虚拟支付 uni-app、uni-app x 短剧类目的微信小程序需要使用微信虚拟支付代替原先的微信支付才能上架 微信小程序虚拟支付
付款码支付 uni-app、uni-app x 商家扫用户的付款码支付 支付宝当面付、微信付款码支付
华为支付 uni-app、uni-app x 发起华为支付 华为支付
iOS 内购支付(appleiap) uni-app In-App Purchase,是指苹果 App Store 的应用内购买 苹果应用内购
抖音小程序支付 uni-app 在抖音小程序中支付 抖音支付

微信支付 API 支持 V2 版本和 V3 版本,详情请看支付配置

安装步骤

点击查看『安装步骤』

配置支付参数文件

点击查看『配置支付参数文件』

后端 SDK(云函数)

点击查看『后端 SDK(云函数)』

前端 SDK(页面)

点击查看『前端 SDK(页面)』

createPayment 支持 loading 和 title 请求参数,与 action、data 同级。loading 默认为 true;title 可自定义加载提示文字,省略时保留各阶段原有文案(支付请求时为“请求中...”)。设置 loading: false 或 title: '',均可关闭本次支付请求、后续结果查询及 iOS 内购过程中的组件加载提示,并跳过对应的 uni.hideLoading() 调用。

this.$refs.vkPay.createPayment({
  ...paymentOptions, // 原有支付参数
  loading: false, // 也可以使用 title: ''
});

需要自定义提示文字时,在原有支付参数中增加 title: '正在创建订单...' 即可;同时传入 loading: false 时仍不显示。

示例项目运行教程

点击查看『示例项目运行教程』

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无