更新记录

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 编译;应用检测、直通列表及支付结果回调尚需在宿主应用真机验证。

接入

  1. 将本插件导入应用的 uni_modules,制作包含银联原生库的自定义基座或离线安装包。标准基座没有这些库。
  2. 商户服务端向银联申请 TN,再把 TN 返回给应用。不要把商户签名证书或密码放在客户端。
  3. iOS 应用注册唯一 URL Scheme,调用时传入相同的 scheme。例如应用注册 myapp-unionpay,调用时也传入 myapp-unionpay。
  4. 调用示例:
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 插件市场要求提供材料。本插件并非中国银联官方产品。

隐私、权限声明

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

Android:INTERNET、ACCESS_NETWORK_STATE、ACCESS_WIFI_STATE;iOS:需由宿主应用配置支付回跳 URL Scheme。

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

本封装不主动采集或上传业务数据。支付 TN 由宿主应用传入,银联原生 SDK 按其官方规则处理支付相关数据;接入方应核对银联 SDK 隐私说明并在应用隐私政策中披露。

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

无

暂无用户评论。