更新记录
0.2.0(2026-11-20)
- 增加
checkIsPaymentAppInstalled和getDirectApps。 - 增加支付返回的
result回调,提供success、fail、cancel、unknown前台状态。 - 前台结果仅供界面展示,订单状态仍须查询商户服务端。
0.1.0(2026-11-20)
- 提供银联 TN 支付控件的 Android 和 iOS UTS 接口。
- 支持 iOS URL Scheme 回跳处理。
平台兼容性
uni-app(4.52)
| Vue2 | Vue2插件版本 | Vue3 | Vue3插件版本 | Chrome | Safari | app-vue | app-nvue | Android | Android插件版本 | iOS | iOS插件版本 | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | 0.1.0 | √ | 0.1.0 | - | - | - | - | 5.0 | 0.1.0 | 15 | 0.1.0 | × |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| - | - | - | - | - | - | - | - | - | - | - | - |
uni-app x(4.52)
| Chrome | Safari | Android | Android插件版本 | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|---|
| - | - | 5.0 | 0.1.0 | - | × | - |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| √ | √ | √ | √ |
银联线上收银台 UTS 插件
通过银联移动支付控件拉起收银台。插件只负责客户端发起支付;商户服务端生成 TN、接收银联通知并查询订单。客户端回调及 success 仅表示控件已启动,不能据此认定支付成功。
已验证范围
- uni-app:Android 真机拉起收银台;iOS 真机启动和支付页联调。iOS 支付完成回跳仍需单独确认。
- uni-app x:Android 真机。iOS 尚未完成真机验证。
- 不支持 Web、小程序和 HarmonyOS。
- 验证环境:HBuilderX 5.34、银联测试环境。生产环境及其他版本需自行复测。
- 0.2.0 新增接口已通过 Android Kotlin 和 iOS Xcode 编译;应用检测、直通列表及支付结果回调尚需在宿主应用真机验证。
接入
- 将本插件导入应用的
uni_modules,制作包含银联原生库的自定义基座或离线安装包。标准基座没有这些库。 - 商户服务端向银联申请 TN,再把 TN 返回给应用。不要把商户签名证书或密码放在客户端。
- iOS 应用注册唯一 URL Scheme,调用时传入相同的
scheme。例如应用注册myapp-unionpay,调用时也传入myapp-unionpay。 - 调用示例:
import { pay } from '@/uni_modules/hege-unionpay'
pay({
tn: serverIssuedTn,
mode: '01', // 测试环境;生产环境为 '00'
scheme: 'myapp-unionpay', // iOS 必填
success: () => console.log('收银台已启动'),
result: ({ status }) => {
console.log('银联前台结果:', status) // success / fail / cancel / unknown
// 随后查询商户服务端订单状态;此处不能直接显示支付成功。
},
fail: (error) => console.error(error.code, error.message)
})
应用检测与直通应用列表:
import { checkIsPaymentAppInstalled, getDirectApps } from '@/uni_modules/hege-unionpay'
const options = { mode: '00', merchantID: merchantId }
const installed = checkIsPaymentAppInstalled(options)
getDirectApps(options, ({ status, result, code, message }) => {
if (status === 'succ') console.log('可用应用:', result)
else console.error(code, message)
})
merchantID 是商户号;旧项目中通常来自 merId。getDirectApps 为异步接口,检测和查询必须传入与 TN 对应的环境。pay.success 仅表示控件启动;支付返回状态在 result 中。
支付完成后,以商户服务端的异步通知和交易查询结果确认订单状态。mode 必须与 TN 所属环境一致。
平台配置
- Android 原生库及网络权限位于
utssdk/app-android。 - iOS 原生框架位于
utssdk/app-ios/Frameworks;应用必须配置支付回跳 URL Scheme。接入前确认宿主工程的打包设置与银联 SDK 版本匹配。 - 隐私披露和系统权限应结合宿主应用及银联 SDK 的实际行为核对。
发布前确认
本插件含银联官方 Android/iOS SDK 二进制文件。公开发布前,发布者必须确认取得相应再分发许可,并按 DCloud 插件市场要求提供材料。本插件并非中国银联官方产品。

收藏人数:
购买普通授权版(
试用
使用 HBuilder 导入示例项目
赞赏(0)
下载 0
赞赏 0
下载 12777488
赞赏 1960
赞赏
京公网安备:11010802035340号