更新记录

1.0.1(2026-11-20)

  • 精简文档:只保留功能与用法说明,去掉实现细节。

  • 提供 pay / getPayModes / checkSEPay / getVersion

  • 支付流程全链路封装:组单 → 请求商户后台 → 解析签名串 → 拉起收银台 → 结果回传解构

  • 内置 14 种支付方式映射(云闪付/快捷/支付宝/微信/各手机Pay/外卡/网银)

  • 手机 Pay 能力检测,直接返回可用的 payMode

  • 下单失败、网络异常、用户取消、支付失败统一错误码(914 段)

  • 不额外打包网络库,与宿主共用,避免冲突

1.0.0(2026-11-20)

  • 首版发布,封装银联移动收银台能力
  • 提供 pay / getPayModes / checkSEPay / getVersion
  • 支付流程全链路封装:组单 → 请求商户后台 → 解析签名串 → 拉起收银台 → 结果回传解构
  • 内置 14 种支付方式映射(云闪付/快捷/支付宝/微信/各手机Pay/外卡/网银)
  • 手机 Pay 能力检测,直接返回可用的 payMode
  • 下单失败、网络异常、用户取消、支付失败统一错误码(914 段)
  • 剔除 aar 中与宿主冲突的 application 属性与 NFC 声明,避免 manifest 合并失败
  • 不打包 okhttp,复用运行时依赖,避免重复类

平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
× × √ × × ×

其他

多语言 暗黑模式 宽屏模式 蒸汽模式
× × × √

uni-pay-chinapay · 银联电子移动收银台

封装银联移动收银台能力,一次集成覆盖:云闪付、快捷支付、华为/小米/三星/vivo/魅族/联想/中兴 手机 Pay、 支付宝、微信、外卡、个人网银。

支付流程

App(本插件)            商户后台(自己的)           银联
   │   提交订单   →   │   签名加密   →   │
   │   ← 签名串                          │
   │   拉起收银台                         │
   │   ←────────── 支付结果 ──────────│

插件负责「组单 → 调后台 → 拉起收银台 → 解析结果」。签名与加密必须在服务端完成, 私钥不能放进客户端——这是规范要求,也是安全底线。

商户后台需要返回什么

插件把订单信息 POST 到 appServerUrl,后台签名后返回三个字段即可:

CardTranData=xxxx&RiskData=xxxx&Signature=xxxx

JSON 格式同样支持。

快速上手

import { pay } from '@/uni_modules/uni-pay-chinapay'

pay({
  merId: '你的商户号',
  appServerUrl: 'https://your-server.com/order',
  merBgUrl: 'https://your-server.com/notify',
  amount: 1,              // 单位:分
  mode: '01',             // 00 生产 / 01 测试 / 03 本地联调
  payMode: '',            // 留空 = 打开收银台首页
  success: (res) => {
    console.log('支付成功', res.respCode, res.orderInfo)
  },
  fail: (err) => {
    console.log(err.errCode, err.errMsg, err.respCode)
  }
})

指定支付方式(跳过收银台首页):

pay({ ...base, payMode: 'MUP', tranType: '0005' })   // 云闪付
pay({ ...base, payMode: 'KJP', tranType: '0004', merUserId: 'user001' })  // 快捷

API

方法 说明
pay(options) 发起支付,结果通过 success / fail 回调
getPayModes(options) 返回内置支付方式表
checkSEPay(options) 检测本机手机 Pay(华为/小米/三星…),返回可用 payMode
getVersion() 插件版本

pay 参数

字段 必填 说明
merId ✅ 商户号
appServerUrl ✅ 商户后台下单地址
merBgUrl ✅ 支付结果后台通知地址
amount ✅ 金额,单位分
merOrderNo 订单号,不传自动生成
mode 00 生产 / 01 测试 / 03 本地,默认 01
payMode 支付方式,留空进收银台首页
tranType 交易类型,配合 payMode
merUserId 快捷支付用户标识
tranReserved 交易保留域(明文传,参与签名)
merResv / commodityMsg / merPageUrl / bankInstNo / payTimeout 见银联文档
accessType 0 商户 / 1 机构
acqCode 收单机构号,默认 000000000000014

success 返回

{
  errCode: 0,
  errMsg: 'ok',
  success: true,        // respCode === '0000'
  respCode: '0000',
  respMsg: '交易成功',
  orderInfo: '...',
  merOrderNo: '20261120...'
}

支付方式(getPayModes)

code 名称 tranType 说明
'' 收银台首页 - 用户自行选择
MUP 云闪付 0005 跳云闪付 App
KJP 快捷支付 0004 需 merUserId
ALP 支付宝 0005 收银台内跳转
WXP 微信支付 0005 需宿主提供微信回调页
HWP 华为 Pay 0005 仅华为设备
XMP 小米 Pay 0005 仅小米设备
SXP 三星 Pay 0005 仅三星设备
VVP vivo Pay 0005 仅 vivo
MZP / LSP / CZP 魅族 / 联想 / 中兴 Pay 0005 对应设备
FCP 外卡 0001 Visa/Master/JCB
PBP 个人网银 0001 目前仅招行

微信支付(WXP)额外配置

微信支付要求回调页类名固定为 <applicationId>.wxapi.WXEntryActivity(平台要求), 这个类必须由宿主 App提供,插件无法预置。若要用微信支付,需要在宿主工程里补一个类:

package 你的包名.wxapi;   // 例如 uni.UNI01C1EBC.wxapi

public class WXEntryActivity extends Activity {
    // 把回调交给支付组件处理
}

并在清单声明:

<activity android:name="你的包名.wxapi.WXEntryActivity"
    android:exported="true" android:launchMode="singleTask" />

不用微信支付则完全无需这一步。

错误码

错误码 说明
9140001 参数错误
9140002 商户后台下单失败(返回缺少签名串)
9140003 网络异常 / 后台无响应
9140004 未安装对应的支付应用
9140005 用户取消支付
9140006 支付失败
9140007 支付能力不可用(如鸿蒙)
9140008 无法拉起收银台
9140009 内部错误

fail 回调对象额外带 respCode / respMsg,便于定位银联应答。

注意事项

  • 必须打自定义基座:插件内置 3 个原生依赖。
  • 金额单位是分,0.01 元 传 1。
  • 必须在服务端签名,客户端只做组单。
  • 生产环境请把 mode 设为 00,并用正式商户号。
  • 收银台界面由银联提供,样式不可定制。
  • 不额外打包网络库,复用宿主运行时能力。
  • 鸿蒙平台暂不支持该能力,调用统一返回 9140007。

平台支持

平台 支持
Android ✅
鸿蒙 ❌(API 形状一致,返回 9140007)
iOS ❌

隐私、权限声明

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

需要 INTERNET、ACCESS_NETWORK_STATE、ACCESS_WIFI_STATE、CHANGE_NETWORK_STATE、READ_PHONE_STATE(由银联 SDK 与收银台使用)

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

插件不采集、不上传任何用户数据;订单报文仅发往开发者自己配置的商户后台(appServerUrl)

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

无

暂无用户评论。