property-resident-side/property-uniapp-project/uni_modules/liyahong-unionpay

##插件功能概述

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

##插件接入文档

关于更新

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

特别推荐

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

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

鸿蒙特殊说明重要授权说明

• uni-app项目: 由于官方目前不支持试用以及普通授权，建议新建uni-appx项目引用插件测通后购买源码授权使用
• uni-appx项目: 可直接使用

###准备工作

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端：usb连接真机 ---> 运行 ---> 运行手机或模拟器 ---> 运行到鸿蒙 ---> 配置证书（可以自动生成） ---> 运行

###接入步骤

最简单的接入步骤（基本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执行完成准备工作，将moudle.json5文件拷贝至harmony-configs -> entry -> src -> main目录下
• step6.1：module.json5路径：unpackage -> dist -> dev -> app-harmony -> entry -> src -> main
• step6.2：修改module.json5文件，新增以下代码

"module": {
	...
	"pages": "$profile:main_pages",
	"querySchemes": [
		"uppaywallet",
		"uppaysdk",
	],
	"abilities": [
		{
			...
			"skills": [
				{
					...
					"uris": [
						{
							"scheme": "uppaylyhuts",
						}
					]
				}
			]
		}
	]
}

• step7：运行项目

详细接入步骤及其他细则

1. 使用插件

• 1. 插件方法说明（HX其实都有提示，再赘述一遍吧，别嫌我啰嗦哈）

  • checkWalletInstalled() 检查是否安装云闪付App，返回true或者false

  • startPay(object) 拉起云闪付app并发起支付，具体说明见下

  • getDirectApps(function) 检查已安装的支持直通模式的银行app列表。用途是在服务端生成tn时，保留域传入"supportBank": "银行标识"。感谢用户cha***@126.com的修正

    ---

    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

手机品牌	seType
Samsung Pay	02
Huawei Pay	04
Meizu Pay	27
Le Pay	30
Mi Pay	25
OPPO Pay	29
vivo Pay	33
Smartisan Pay	32
realme Pay	35

3. 代码示例

// uniapp项目引入方式
import { checkWalletInstalled, getDirectApps, startPay } from '../../uni_modules/liyahong-unionpay'
// uniappx项目引用方式（注意：uniappx项目必须使用@符号的方式引用，否则会报路径找不到的问题）
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时使用，举例：supportBank:CQP

银行标识	银行 APP 名称
CQP	云闪付
CMBCC	全民生活
PAB	平安口袋银行
CCB	中国建设银行
BoCom	交通银行
ABC	中国农业银行
CMB	招商银行
CMBLIFE	掌上生活
ICBC	中国工商银行
SPDB	浦发银行
SPDBC	浦大喜奔
CNCB	中信银行手机银行
GDBC	发现精彩
CIBC	兴业生活（好兴动）
HXBC	华彩生活
BCCBC	掌上京彩
BOCC	中国银行缤纷生活
CEBC	阳光惠生活
ICBCC	工银 e 生活
CCBC	建行生活
BoComC	买单吧
GDB	广发银行手机银行
PSBC	邮储银行
PSBCC	邮储信用卡
CEB	光大银行手机银行
BOS	上海银行手机银行
SHBANK	上银美好生活
CNCBC	动卡空间
CMBC	民生银行手机银行
CIB	兴业银行手机银行
BOC	中国银行
BCCB	京彩生活
ABCC	农银 e 管家
HXB	华夏手机银行

5. iOS访问白名单对照表

支付 APP scheme	对应支付 APP
uppaysdk	云闪付 APP
uppaywallet	云闪付 APP
uppayx1	全民生活
uppayx2	预留
uppayx3	预留
paesuperbank	平安口袋银行
ccbmbsylunionpay	中国建设银行
bocom	交通银行
bankabc	中国农业银行
cmbmobilebank	招商银行
cmblife	掌上生活
com.icbc.iphoneclient	中国工商银行
spdbbank	浦发银行
spdbcccUnionPay	浦大喜奔
citicbankpay	中信银行手机银行
credit	发现精彩
uppayxingyecredit	兴业生活（好兴动）
uppayhuaxiacredit	华彩生活
uppaybeijingcredit	掌上京彩
uppayzhonghangcredit	中国银行缤纷生活
uppayguangdacredit	阳光惠生活
uppaygonghangcredit	工银 e 生活
uppayjianhangcredit	建行生活
uppayjiaohangcredit	买单吧
uppayguangfa	广发银行手机银行
psbccashier	邮储银行
uppayyouchucredit	邮储信用卡
com.cebbank.ebank	光大银行手机银行
BankOfShangHai	上海银行手机银行
boscgdlf	上银美好生活
citicbankdkkj	动卡空间
cmbc	民生银行手机银行
cibmb	兴业银行手机银行
bocmbankpsn	中国银行
bankofbjpay	京彩生活
uppaynonghangcredit	农银 e 管家
uppayhuaxia	华夏手机银行
zytuppay	中银通
LZYHSJYHAUTHSSOAPP	兰州银行
bnbpay	宁波银行
dlrcb	大连农商行
czbank	浙商银行
uppayCbhb	渤海银行

6. 其他附属

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

测试	生产
https://appcashier.test.cup.com.cn	https://conf.cup.com.cn
https://appcashier.test.95516.com	https://conf.95516.com
	https://acpstatic.cup.com.cn
	https://acpstatic.95516.com
	https://appcashier.95516.com

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

7. 已知问题

• Q：频繁调用getDirectApps、startPay函数会导致callback回调触发多次？感谢用户：[爱心]GLL
• A：多页面可以通过页面路径来判断是否是当前页面触发，如果是再执行下一步操作，否则拦截