更新记录
1.0.1(2025-07-09)
完善readme, 增加调用示例
1.0.0(2025-07-09)
第一版发布,仅支持Android 云闪付SDK版本:Android:v3.1.8 初次发布,如有问题请大家多多指出,会及时调整
平台兼容性
uni-app x(4.66)
Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
---|---|---|---|---|---|
× | × | 8.0 | × | × | × |
zhw-uppaysdk
开发文档
详细接入步骤及其他细则
-
使用插件
- 1) 插件方法说明
- zhwQmfPay(function)
zhwQmfPay
方法说明参数说明(入参为object)
属性 类型 默认值 必填 说明 mode string '00' 是 银联环境,可选项00/01,00正式环境,01测试环境 data string 无 是 服务端返回的交易流水号,即tn channel string union 否 默认值无需更改
success function 无 是 支付结果回调,回参为 object
,属性见返回值说明
fail function 无 是 支付结果回调,回参为 object
,属性见返回值说明
complete function 无 是 支付结果回调,回参为 object
,属性见返回值说明
返回值说明
属性 返回值说明 errCode 【必填】状态码,1 :前台支付成功,存在不确定性,需要后端查询订单实际支付结果(基于data中的签名判断)、-1:支付异常、支付取消 errMsg 【必填】提示信息 name data 【必填】返回结果数据 -
代码示例
import { zhwQmfPay } from '../../uni_modules/zhw-uppaysdk'
/**
* 拉起云闪付进行支付
*/
startPay() {
zhwQmfPay({
data: '',
mode: '00',
channel: 'union',
success: (res) => {
console.log('success', res);
if (res.errCode == '1' && res.name == 'SuccessPay') { // 解析res.data
let str = data.getExtras().getString("pay_result");
if (str == 'success') {
//如果想对结果数据校验确认,直接去商户后台查询交易结果,
//校验支付结果需要用到的参数有sign、data、mode(测试或生产),sign和data可以在result_data获取到
/**
* result_data参数说明:
* sign —— 签名后做Base64的数据
* data —— 用于签名的原始数据
* data中原始数据结构:
* pay_result —— 支付结果success,fail,cancel
* tn —— 订单号
*/
msg = "云闪付支付成功";
} else if (str == 'fail') {
msg = "云闪付支付失败!";
} else if (str == 'cancel') {
msg = "用户取消了云闪付支付";
}
}
},
fail: (err) => {
console.log('err', err);
uni.showToast({
title: err.errMsg,
icon: 'none'
})
}
})
}