更新记录
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 | ❌ |

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 1
赞赏 0
下载 12778098
赞赏 1960
赞赏
京公网安备:11010802035340号