更新记录

1.1.1（2026-04-07）

优化问题

1.1.0（2026-04-07）

新增 HarmonyOS NEXT 平台支持，三端统一 API

• 新增 HarmonyOS 端完整支付实现（startPay、isUnionPayInstalled）
• 通过 onNewWant 监听支付结果回跳，自动处理回调
• 通过 bundleManager.canOpenLink 检测云闪付安装状态
• 内置 libuppayment.har SDK（v3.1.2）
• 支持 HarmonyOS NEXT API 12+

1.0.0（2026-01-19）

新增安卓，ios端云闪付，内置sdk集成自动处理回调

平台兼容性

uni-app(4.81)

uni-app x(4.81)

jwh-pay 云闪付支付插件

简介

uni-app / uni-app-x 云闪付支付插件，支持 Android、iOS、HarmonyOS NEXT 三端，已内置云闪付 SDK，开箱即用。

功能

• 拉起云闪付完成支付
• 检测云闪付 App 是否安装
• 支付结果自动回调，返回状态码、中文描述和签名
• 正式环境 / 测试环境一键切换
• 支持 scheme、seType 等参数
• result / callback 两种回调写法都支持

平台兼容

安装

HBuilderX 插件市场搜索 jwh-pay 导入，或者把插件目录丢到 uni_modules 下就行。

注意： 这是原生插件，标准基座跑不了。需要先在 HBuilderX 里「制作自定义调试基座」，再用自定义基座运行。正式打包不受影响。

各平台配置

Android

不需要额外配置，权限和 SDK 都已经内置好了。

iOS

1. manifest.json → app-plus → distribute → ios → urlschemewhitelist 加上：

   uppaysdk,uppaywallet,uppayx1,uppayx2,uppayx3

2. manifest.json → app-plus → distribute → ios → urltypes 加上你的自定义 scheme，支付完成后云闪付会跳回来：

   myapp

HarmonyOS

1. 项目的 module.json5 里，abilities → skills 加一组配置，用于支付完成后跳回你的应用：

   {
    "entities": ["entity.system.browsable"],
    "actions": ["ohos.want.action.viewData"],
    "uris": [{ "scheme": "myapp", "host": "uppayresult" }]
   }

   把 myapp 换成你自己的 scheme，要和调用 startPay 时传的 scheme 一样。

2. 如果要用 isUnionPayInstalled() 检测云闪付是否安装，module.json5 里还需要加：

   {
    "module": {
      "querySchemes": ["uppaysdk"]
    }
   }

3. 鸿蒙项目要先导入插件再打包，具体看：https://uniapp.dcloud.net.cn/tutorial/harmony/runbuild.html

用法

import { startPay, isUnionPayInstalled } from "@/uni_modules/jwh-pay";

// 检查是否安装了云闪付
const installed = isUnionPayInstalled();
console.log('云闪付已安装:', installed);

// 发起支付
function pay(tn) {
  startPay({
    tn: tn,            // 交易流水号，找后端要
    mode: "00",         // 00 正式，01 测试
    scheme: "myapp",    // 你的 scheme，iOS 和鸿蒙需要
    result: (res) => {
      if (res.status === "00") {
        uni.showToast({ title: '支付成功', icon: 'success' });
        // res.sign 可以拿去给后端验签
      } else if (res.status === "69") {
        uni.showToast({ title: '取消了', icon: 'none' });
      } else {
        uni.showToast({ title: res.message || '支付失败', icon: 'none' });
      }
    }
  });
}

API

startPay(options)

拉起云闪付支付。

result 和 callback 传一个就行，都传的话用 result。

isUnionPayInstalled()

检测手机上有没有装云闪付，返回 true / false。

鸿蒙端需要在 module.json5 里配好 querySchemes，不然一直返回 false。

回调参数

常见状态码

完整状态码看银联文档：https://open.unionpay.com/

注意

1. tn 必须从后端拿，不能前端自己编
2. 测试用 mode: "01"，上线记得改成 "00"
3. 客户端拿到的支付结果只能做展示，最终结果以后端回调为准
4. 支付成功返回的 sign 要传给后端做验签
5. 鸿蒙模拟器上装不了云闪付，要在真机上测

报错排查

seType 对照表

更新记录

v1.1.0 (2026-04-07)

• 新增 HarmonyOS NEXT 支持
• 鸿蒙端支付结果通过 onNewWant 回跳处理
• 鸿蒙端可检测云闪付安装状态
• 内置 libuppayment.har v3.1.2

v1.0.1 (2026-04-03)

• 回调新增 message 字段
• result / callback 双回调兼容
• Android sign 解析不再依赖字段顺序
• Android ActivityResult 加了 requestCode 过滤
• iOS 用 connectedScenes 替代废弃的 keyWindow
• 三端 sign 处理统一
• 清理多余日志

v1.0.0 (2026-01-19)

• 首版，支持 Android + iOS 云闪付支付