更新记录

1.0.0（2026-06-09）

发布版本

平台兼容性

uni-app(4.56)

uni-app x(4.56)

jwh-jhlzf

建行龙支付、微信 App 支付、支付宝 App 支付 UTS 插件。支持 App Android、App iOS、HarmonyOS。

配置总览

先准备这些值：

按支付方式配置

龙支付：provider: 'ccb'

聚合支付：provider: 'aggregate'

如果聚合页里要使用微信渠道，再按“微信支付”补齐微信开放平台配置。如果聚合页里要使用支付宝渠道，再按“支付宝支付”确认支付宝 scheme 配置。

微信支付：provider: 'wechat'

支付宝支付：provider: 'alipay'

Android 必配

1. 修改建行回跳 action

文件位置：

uni_modules/jwh-jhlzf/utssdk/app-android/AndroidManifest.xml

找到：

<activity
  android:name="com.ccb.ccbnetpay.activity.appresult.ResultActivity"
  android:configChanges="orientation|keyboardHidden|screenSize"
  android:exported="true"
  android:screenOrientation="portrait"
  tools:node="merge">
  <intent-filter>
    <action android:name="comccbpay你的商户号xxx" />
    <category android:name="android.intent.category.DEFAULT" />
  </intent-filter>
</activity>

只改 <action> 这一行：

<action android:name="<ccbThirdAppInfo>" />

2. 检查微信回跳入口

文件位置：

uni_modules/jwh-jhlzf/utssdk/app-android/AndroidManifest.xml

保留：

<activity-alias
  android:name="${applicationId}.wxapi.WXPayEntryActivity"
  android:exported="true"
  android:targetActivity="uts.sdk.modules.jwhJhlzf.WXPayEntryActivity"
  android:theme="@android:style/Theme.Translucent.NoTitleBar"
  tools:node="merge" />

3. 配置微信开放平台

使用 provider: 'wechat' 时必须配置：

4. 不启用内置支付模块

文件位置：

manifest.json

不要配置 HBuilderX 内置支付：

{
  "app-plus": {
    "modules": {
      "Payment": {}
    },
    "distribute": {
      "sdkConfigs": {
        "payment": {}
      }
    }
  }
}

插件已声明：

iOS 必配

1. 配置 URL Schemes

文件位置：

manifest.json

配置位置：

{
  "app-plus": {
    "distribute": {
      "ios": {
        "urltypes": "<ccbThirdAppInfo>,<wechatAppId>"
      }
    }
  }
}

填写规则：

2. 配置微信开放平台

使用 provider: 'wechat' 时必须配置：

3. 插件已声明

不要额外引入 WechatOpenSDK。

HarmonyOS 必配

1. 配置 querySchemes

文件位置按你的 HarmonyOS 工程结构，一般是：

entry/src/main/module.json5

按使用渠道配置：

示例：

{
  module: {
    querySchemes: [
      "ccbapp",
      "mbspay",
      "weixin",
      "wxopensdk",
      "https",
      "alipays"
    ]
  }
}

2. 微信支付初始化参数

使用 provider: 'wechat' 时必须传：

initPayment({
  wechatAppId: '<wechatAppId>',
  want: harmonyWant
})

3. 插件已声明

服务端必配

服务端返回完整建行订单参数串 orderInfo：

MERCHANTID=...&POSID=...&BRANCHID=...&ORDERID=...&PAYMENT=...&TXCODE=...&THIRDAPPINFO=<ccbThirdAppInfo>&MAC=...

必须保持一致：

当前示例值替换清单：

快速接入

1. 引入插件

import {
  initPayment,
  pay,
  isAppInstalled,
  getSDKVersion
} from '@/uni_modules/jwh-jhlzf'

2. 选择支付渠道

3. 复制支付代码

let wechatReady = false

function ensureWechatPaymentReady(provider, done) {
  if (provider !== 'wechat') {
    done()
    return
  }

  if (wechatReady) {
    done()
    return
  }

  initPayment({
    wechatAppId: '<wechatAppId>',
    universalLink: '<wechatUniversalLink>',
    // HarmonyOS 微信支付时传入当前 want
    // want: harmonyWant,
    success: () => {
      wechatReady = true
      done()
    },
    fail: (err) => {
      console.log('微信支付初始化失败', err)
    }
  })
}

function startPayment(provider, orderInfo) {
  if (!orderInfo) {
    console.log('orderInfo 不能为空')
    return
  }

  if (!isAppInstalled({ provider })) {
    console.log('未安装对应支付 App')
    return
  }

  ensureWechatPaymentReady(provider, () => {
    pay({
      provider: provider,
      orderInfo: orderInfo,
      success: (res) => {
        console.log('支付成功', res)
      },
      fail: (err) => {
        if (err.errCode === 9010007) {
          console.log('用户取消支付', err)
          return
        }
        console.log('支付失败', err)
      },
      complete: (res) => {
        console.log('支付结束', res)
      }
    })
  })
}

4. 发起支付

startPayment('ccb', orderInfo)
startPayment('aggregate', orderInfo)
startPayment('wechat', orderInfo)
startPayment('alipay', orderInfo)

直接调用：

pay({ provider: 'ccb', orderInfo })
pay({ provider: 'aggregate', orderInfo })
pay({ provider: 'wechat', orderInfo })
pay({ provider: 'alipay', orderInfo })

API 参数

initPayment

微信支付初始化。

initPayment({
  wechatAppId: '<wechatAppId>',
  universalLink: '<wechatUniversalLink>',
  want: harmonyWant,
  success: (res) => {},
  fail: (err) => {},
  complete: (res) => {}
})

pay

发起支付。

pay({
  provider: 'ccb',
  orderInfo: orderInfo,
  success: (res) => {},
  fail: (err) => {},
  complete: (res) => {}
})

isAppInstalled

检查支付 App。

const installed = isAppInstalled({ provider: 'wechat' })

getSDKVersion

查看 SDK 版本。

console.log(getSDKVersion())

provider 对应入口

回调数据

成功回调：

{
  provider: 'ccb',
  status: 'success',
  errCode: 0,
  errMsg: 'pay:ok',
  raw: {}
}

失败回调：

{
  errCode: 9010006,
  errMsg: '支付失败：...',
  provider: 'ccb',
  raw: {}
}

常见返回

err.raw 保留 SDK 原始错误；err.errMsg 可能包含“原始错误”。