更新记录

1.0.4(2025-01-08)

移出ios下的plist文件

1.0.3(2025-01-07)

修复安卓下判断失效的问题 去除了安卓支付下校验是否安装软件的问题,与ios保持同步。由使用者自行校验

1.0.2(2025-01-06)

修复了插件在ios下打包失败的问题 修复使用说明中代码单词错误

查看更多

平台兼容性

Vue2 Vue3
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=>{},// 处理后续支付逻辑
})

其他说明

  1. 后续功能预告 getDirectApps()检查已安装的支持直通模式的银行app列表;getPayInfo()获取手机信息<安卓可用>;
  2. 因没有Harmony Next系统手机,所以暂未实现兼容Harmony.后续会考虑兼容;
  3. 目前插件处于测试阶段,欢迎试用.有问题或有其他需求可随时与我沟通;
  4. IOS配置白名单:(uppaysdk、uppaywallet、upwallet、upopen、upcommon、uppayx1、uppayx2、uppayx3)这八项建议都添加
  5. 如果使用直通模式,一定要添加相应银行白名单;
  6. 其他问题请参见中国银联开放平台;

隐私、权限声明

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

<uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.QUERY_ALL_PACKAGES" />

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

插件不采集任何数据

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

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问