更新记录

1.2.0（2026-09-29）

1.2.0 独立上架包去除商户品牌默认配置 initialize必填appScheme微信支付宝回跳Scheme与UniversalLink由接入方传入 新增js_sdk封装 AndroidManifest与Infoplist使用YOUR占位 已内置银商云闪付等原生SDK二进制

平台兼容性

uni-app(3.8.4)

银联商务原生支付 UTS 插件

App 端调起银商原生支付：云闪付 / 银商微信 / 银商支付宝小程序。

插件不含商户号、进件、服务端下单与签名。所有 Scheme、微信 AppId、Universal Link 均由你自行配置。

支付宝小程序请走 ALIPAY_MINI，不要改成 uni.requestPayment({ provider: 'alipay' }) 直调（易出现「交易订单处理失败」）。

1. 安装与 SDK

1. 将本插件放入项目 uni_modules/lnpay-chinaumspay（或从插件市场导入）。
2. 本包已内置银商/云闪付等原生 SDK。若需升级官方版本，可执行：

chmod +x script/copy-chinaums-sdk.sh
./script/copy-chinaums-sdk.sh /path/to/银商SDK根目录
./script/verify-chinaums-plugin.sh

3. 必改占位：将下列 YOUR_* 换成你自己的值后再打包（见下一节）。
4. 制作并安装包含本插件的自定义调试基座（标准基座无法使用）。

付费授权版仅支持云端传统打包，不支持离线打包 / 安心打包。

2. 你需要准备的配置

另需：你的应用包名、DCloud appid（购买授权时绑定）、银商商户与服务端。

2.1 修改插件内占位

2.2 修改项目 manifest.json

• Android / iOS schemes：填入 appScheme、alipayMiniScheme
• iOS urlschemewhitelist 建议包含：

alipay,alipays,weixin,weixinULAPI,weixinURLParamsAPI,uppaysdk,uppaywallet,uppayx1,uppayx2,uppayx3

• 微信开放平台配置的 Universal Links 须与 initialize.universalLink 完全一致。

3. 初始化与回跳

推荐使用 JS 封装（带「未配置则失败」校验）：

import {
  initialize,
  handleOpenURL,
  handleOpenUniversalLink,
  upPay
} from '@/uni_modules/lnpay-chinaumspay/js_sdk/chinaums-pay.js'

// App.vue
export default {
  onLaunch() {
    initialize({
      appScheme: 'yourappscheme',
      cloudPayScheme: 'yourappscheme',
      alipayMiniScheme: 'youralipayback',
      wechatAppId: 'wx你的AppId',
      universalLink: 'https://your.domain/app/'
    })
  },
  onShow(options) {
    const url = (options && (options.arg || options.path)) || ''
    const text = String(url)
    if (!text) return
    if (text.indexOf('https://') === 0 || text.indexOf('http://') === 0) {
      handleOpenUniversalLink(text)
    } else {
      handleOpenURL(text)
    }
  }
}

也可直接 import from '@/uni_modules/lnpay-chinaumspay' 调用原生 UTS API（同样需先 initialize）。

4. 调起支付

服务端：按银商文档下单，返回带签名的 appPayRequest（JSON 字符串）。插件不做签名。

upPay({
  bizChannel: 'CLOUDPAY', // 或 ALIPAY_MINI / WECHAT_MINI
  appPayRequest: serverReturnedJsonString,
  success(res) {
    // resultCode === '0000' 仅为客户端成功，请再向服务端查单
  },
  fail(res) {
    // '1000' 多为用户取消
  }
})

支付宝小程序调起时，插件会把 appScheme 写成：

iOS:{你的alipayMiniScheme};Android:{你的appScheme}

结果码

正式业务请以服务端查单 / 异步通知为准。

5. 授权与范围

• 普通授权：加密，绑定 DCloud appid + 包名；源码授权可读 UTS 源码。
• 本插件只提供 App 唤起能力，不提供商户进件、费率、服务端。
• 第三方 SDK 版权归银联商务 / 银联 / 微信 / 支付宝；本插件仅作封装分发，接入方须遵守其许可与商户协议。