更新记录

1.0.0（2025-01-10）

• 第一版发布，同时支持Android、IOS、HarmonyOS三端
• 云闪付SDK版本：Android：v3.5.15，IOS：v3.6.0，HarmonyOS：v3.1.0
• 初次发布，如有问题请大家多多指出，会及时调整

平台兼容性

插件功能概述

• 支持拉起云闪付并完成支付
• 支持检查是否安装云闪付
• 支持获取已安装的云闪付直通App列表
• 支持配置各个直通银行及手机支付(如小米支付、华为支付等)
• 支持Android/IOS/harmonyOS三端本插件为原生SDK，仅支持App端
• 待完善功能。。。

插件接入文档

关于更新

有空闲时间会不断更新维护，有问题随便提，有时间一定会修改！

特别推荐

其他插件请参考主页，如人脸采集、百度OCR等（深受广大用户青睐，可以一试）

• 作者主页：https://ext.dcloud.net.cn/publisher?id=214114

准备工作

1. Android、ios、harmonyOS端证书准备工作
   • 1) Android端：准备应用的Android打包文件.jks文件。(如使用官方证书忽略)参考：https://ask.dcloud.net.cn/article/35777
   • 2) IOS端：这里只简单介绍一下windows系统下如何创建ios证书，如果你是mac系统，直接百度搜索就行，网上一堆教程，windows证书申请教程参考：https://www.pianshen.com/article/59121497532/
   • 3) harmonyOS端：鸿蒙打包文件及配置(需要注意，鸿蒙需要先试用/购买插件，导入插件之后再按照链接执行)，参考：https://uniapp.dcloud.net.cn/tutorial/harmony/runbuild.html

接入步骤

最简单的接入步骤（基本10分钟搞定）

• step1：插件页右边有个试用的按钮，点它，然后弹出来一个模态框，选择试用的项目，点击确认按钮，点击继续导入HBuilderX
• step2：将demo里面index.vue文件里面的函数方法复制过来
• step3：打开你项目的manifest.json文件，找到安卓/iOS常用其他设置，找到IOS设置 ---> UrlSchemes，将uppaylyhuts填写进去。如果你本来就有(比如你原来有XXX)则是：XXX,uppaylyhuts
• step4：同上，在安卓/iOS常用其他设置中找到IOS设置 ---> 应用访问白名单，将uppaywallet,uppaysdk,uppayx1,uppayx2,uppayx3,paesuperbank,ccbmbsylunionpay,bocom,bankabc,cmbmobilebank,cmblife,com.icbc.iphoneclient,spdbbank,spdbcccUnionPay,citicbankpay,credit,uppayxingyecredit,uppayhuaxiacredit,uppaybeijingcredit,uppayzhonghangcredit,uppayguangdacredit,uppaygonghangcredit,uppayjianhangcredit,uppayjiaohangcredit,uppayguangfa,psbccashier,uppayyouchucredit,com.cebbank.ebank,BankOfShangHai,boscgdlf,citicbankdkkj,cmbc,cibmb,bocmbankpsn,bankofbjpay,uppaynonghangcredit,uppayhuaxia,zytuppay,LZYHSJYHAUTHSSOAPP,bnbpay,dlrcb,czbank,uppayCbhb填写进去
• step5：Android/IOS打自定义基座包，然后选择以自定义基座包运行
• step6：harmonyOS执行准备工作的第三条，执行完成之后将demo的entry目录复制过来。如果已经有了请联系我指导你（评论区，因为有邮箱推送）
• step7：运行项目耍起来！

详细接入步骤及其他细则

1. 使用插件

   • 1) 插件方法说明（HX其实都有提示，再赘述一遍吧，别嫌我啰嗦哈）
   • checkWalletInstalled() 检查是否安装云闪付App，返回true或者false
   • startPay(object) 拉起云闪付app并发起支付，具体说明见下
   • getDirectApps(function) 检查已安装的支持直通模式的银行app列表。用途是在服务端生成tn时，保留域传入"ebankEnAbbr" : "银行标识"

   ---

   startPay方法说明

   参数说明（入参为object）

   属性	类型	默认值	必填	说明
   mode	string	无	是	银联环境，可选项00/01，00正式环境，01测试环境
   tn	string	无	是	服务端返回的交易流水号，即tn
   seType	string	无	否	【IOS无效】手机pay支付类别，传入会展示对应的手机支付，如：华为支付就传04，具体说明见seType说明表
   callback	function	无	是	支付结果回调，回参为object，属性见返回值说明

   返回值说明

   属性	返回值说明
   code	【必填】状态码，0：支付成功、1：前台支付成功，存在不确定性，需要后端查询订单实际支付结果(基于data中的签名判断)、-1：支付失败、-2：支付取消
   msg	【必填】提示信息
   data	【选填】支付签名信息，只有code=1的时候返回

   ---

   getDirectApps方法说明

   参数说明（入参为function函数，回参为object，属性见返回值说明）

   返回值说明

   属性	返回值说明
   code	【必填】状态码。0：请求成功、1：请求失败(会将银联的错误code和错误msg都返回在data中，组成一个对象)
   msg	【必填】提示信息
   data	【必填】响应结果。code=0时为Array对象，其中的值代表直通银行标识，详见直通银行标识对照表、code=1是为object对象，是银联的错误对象

2. seType说明表注意：seType是string类型，不是number

3. 代码示例

import { checkWalletInstalled, getDirectApps, startPay } from '../../uni_modules/liyahong-unionpay'

/**
 * 检查是否安装云闪付App
 */
checkInstalled() {
    const result = checkWalletInstalled()
    this.installResult = `是否安装云闪付：${result}`
},
/**
 * 【鸿蒙不支持此功能】获取直通银行App列表
 */
getBankAppList() {
    getDirectApps((result) => {
        console.log(JSON.stringify(result))
    })
},
/**
 * 拉起云闪付进行支付
 */
startPay() {
    startPay({
        tn: '',
        mode: '00',
        callback: (result) => {
            console.log(JSON.stringify(result))
        }
    })
}

4. 直通银行标识对照表服务端生成tn时使用，举例：ebankEnAbbr:CQP

5. iOS访问白名单对照表

6. 其他附属

• 1) 银联测试卡链接：测试卡直达
• 2) 商户需按照以下链接及表格内容配置 IP 及地址白名单。配置服务端白名单链接直达

• 3) Apple Pay需要自行接入，接入参考：链接直达
• 4) 其他问题请参见 https://open.unionpay.com 帮助中心-FAQ