更新记录
1.0.4(2025-01-08)
移出ios下的plist文件
1.0.3(2025-01-07)
修复安卓下判断失效的问题
去除了安卓支付下校验是否安装软件的问题,与ios保持同步。由使用者自行校验
1.0.2(2025-01-06)
修复了插件在ios下打包失败的问题
修复使用说明中代码单词错误
查看更多
平台兼容性
App |
快应用 |
微信小程序 |
支付宝小程序 |
百度小程序 |
字节小程序 |
QQ小程序 |
HBuilderX 3.99,Android:5.0,iOS:9,HarmonyNext:不支持 |
× |
× |
× |
× |
× |
× |
钉钉小程序 |
快手小程序 |
飞书小程序 |
京东小程序 |
鸿蒙元服务 |
× |
× |
× |
× |
× |
H5-Safari |
Android Browser |
微信浏览器(Android) |
QQ浏览器(Android) |
Chrome |
IE |
Edge |
Firefox |
PC-Safari |
× |
× |
× |
× |
× |
× |
× |
× |
× |
银联线上收银台控件
SDK版本
安卓 版本号: 3.5.15(20240112) 更新时间: 2024-01-15 18:07:23
IOS 版本号: 3.6.0(20240924) 更新时间: 2024-09-24 09:12:58
接口说明
调起支付控件,发起支付
startPay(options):void
// 发起支付参数
type options {
tn : string // 交易流水号,商户后台向银联后台提交订单信息后,由银联后台生成并下发给商户后台的交易凭证;
mode : string // "00"代表接入生产环境(正式版本需要);"01"代表接入开发测试环境(测试版本需要);
scheme : string // IOS必填; 商户自定义协议,商户在调用支付接口完成支付后,用于引导支付控件返回而定义的协议
seType ?: string // 可选项(仅安卓可用);手机 pay 支付类别
result : (response : Response) => void // 支付回调
}
// 支付回调参数(回调参数仅供前端参考使用,以后台请求订单状态为准)
type Response = {
status : string // 支付状态码,枚举值:SUCCESS:支付成功; FAIL:支付失败; CANCEL:支付取消
sign ?: string // sign字段用于后台验证,也可以不使用该数据,直接去后台请求当前订单状态
}
检测是否安装云闪付
checkAppInstalled():boolean//返回值,true:已安装,false:未安装.在发起支付前自行判断场景
使用说明
// 引入插件方法
import { startPay, checkAppInstalled } from '@/uni_modules/zz-unionpay';
if(!checkAppInstalled()) return toast('请先安装云闪付App') // toast方法自行实现
const tn = null//从后端接口中获取交易流水号(tn)
// 发起支付
startPay({
tn,
mode: "00",
// 在manifest.json->安卓/IOS常用其他设置->UrlSchemes中设置scheme
scheme: "unionpayConsider",// 此处unionpayConsider替换为自己的Schemes
result:res=>{},// 处理后续支付逻辑
})
其他说明
- 后续功能预告 getDirectApps()检查已安装的支持直通模式的银行app列表;getPayInfo()获取手机信息<安卓可用>;
- 因没有Harmony Next系统手机,所以暂未实现兼容Harmony.后续会考虑兼容;
- 目前插件处于测试阶段,欢迎试用.有问题或有其他需求可随时与我沟通;
- IOS配置白名单:(uppaysdk、uppaywallet、upwallet、upopen、upcommon、uppayx1、uppayx2、uppayx3)这八项建议都添加
- 如果使用直通模式,一定要添加相应银行白名单;
- 其他问题请参见中国银联开放平台;