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

##插件接入文档
### 关于更新
有空闲时间会不断更新维护，有问题随便提，有时间一定会修改！

### 特别推荐
其他插件请参考主页，如人脸采集、百度OCR等（深受广大用户青睐，可以一试）
* 作者主页：[https://ext.dcloud.net.cn/publisher?id=214114](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](https://ask.dcloud.net.cn/article/35777)
* 2) IOS端：这里只简单介绍一下windows系统下如何创建ios证书，如果你是mac系统，直接百度搜索就行，网上一堆教程，windows证书申请教程参考：[https://www.pianshen.com/article/59121497532/](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`文件，新增以下代码
```javascript
"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<string>对象，其中的值代表`直通银行标识`，详见`直通银行标识对照表`、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. 代码示例

```javascript
// 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) 银联测试卡链接：[测试卡直达](https://open.unionpay.com/tjweb/support/faq/mchlist?id=4)
* 2) 商户需按照以下链接及表格内容配置 IP 及地址白名单。[配置服务端白名单链接直达](https://open.unionpay.com/tjweb/support/faq/mchlist?id=228)

|  测试 |  生产  |
| ------------ | ------------ |
| 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需要自行接入，接入参考：[链接直达](https://open.unionpay.com/tjweb/support/faq/mchlist?id=741)
* 4) 其他问题请参见 [https://open.unionpay.com](https://open.unionpay.com) 帮助中心-FAQ

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