8 Star 10 Fork 2

兰途科技-前端团队 / lantu-union-pay

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
ISC

lantu-union-pay

银联手机控件 cordova 插件

A. 简介

集成银联手机控件:

  • Android 手机支付控件开发包(安卓版)3.4.5
  • IOS 手机支付控件开发包(iOS版)3.3.11

F. 安装方法


cordova plugin add https://gitee.com/lantutech/lantu-union-pay.git

J. API

  • cordova.plugins.LantuUnionPay.pay
  • cordova.plugins.LantuUnionPay.isUnionAppInstalled

L. Usage - 使用方法

L.1 支付API


cordova.plugins.LantuUnionPay.pay(options, success, error);

L.1 支付API参数

- { Object } options:

  • { String } tn - 银联交易流水号(支付空间使用)
  • { String } [mode] - 支付模式, "00"代表接入生产环境(正式版本需要)、01"代表接入开发测试环境(测试版本需要)
  • { String } [scheme] - ios scheme for host'app, 一般情况不传

- { Function } success: 支付成功回调:

function success(payResult){ 

	/**
	 * 支付结果
	 * @type { Object } payResult
	 * @property { String } code 支付结果, 候选值 "success"、"fail"、"cancel"
	 * @property { successPaySignData } [successExtraData] 仅有成功时返回
	 */
	payResult;
	
	
	/**
	 * 额外迁移数据( 银联也建议不在客户端做处理, 忽略就好 )
	 * @typedef { Object } successPaySignData
	 * @property { String } sign 签名后做Base64的数据
	 * @property { String } data 用于签名的原始数据,结构如: pay_result=success&tn=899394085660622736701&cert_id=68759585097
	 */
	
}

- { Function } error: 支付失败回调:

function error(payResult){ 

	/**
	 * 支付结果
	 * @type { Object } payResult
	 * @property { String } code 支付结果, 候选值 "fail"、"cancel"
	 */
	payResult;

}

example:

cordova.plugins.LantuUnionPay.pay({
	
	// 可用银联提供仿真tn 进行测试: http://101.231.204.84:8091/sim/getacptn
	tn: "539872438627557871701"
	
}, (payResult) => {
	
	const { code, successPaySignData } = payResult;
	alert(`支付成功 ${ code } !`);
	
	console.log("仅有成功时返回: ", successPaySignData);
	
}, (payResult) => {
	
	const { code } = payResult;
	alert(`支付失败 ${ code }`);
	
});

L.2 嗅探云闪付API 是否安装


cordova.plugins.LantuUnionPay.isUnionAppInstalled(callback);

L.2 参数

- { Function } callback: 执行成功回调:

function callback(isInstalled){ 

	/**
	 * 是否已安装
	 * @type { Boolean } isInstalled
	 */
	isInstalled;

}

N. 注意事项

ios 支付结束结果返回到 app 机制

手机控件是通过 URL Types回调协议, 因此需要在 Xcode 中配置 info.plist 配置 URL TYPES.

lantu-union-pay 插件在安装时候已经做了这一件事, 默认值为 lantumcampusunionpay ios_CFBundleURLTypes

如果有需求调整此配置项, 可自行在插件安装时候, 带上定制的参数( -variable UNION_PAY_URL=* ), 例如:


cordova plugin add https://gitee.com/lantutech/lantu-union-pay.git --variable UNION_PAY_URL=YourCustomizedUrl

X. Todo 清单


Y. Release Log

  • v0.2.4:

    • 修复 ios 在已安装云闪付APP 场景下, 成功支付后崩溃的问题
  • v0.2.3:

    • 新增 插件安装时 定制 UNION_PAY_URL 参数
    • 修复 无法正确拿到支付回调结果
  • v0.2.2:

    • 实现 Android、IOS 核心支付方法, 并在 cordova@8、cordova-android@6.4.1 、cordova-ios@4.5.4 完成测试
ISC License Copyright (c) 2019, pengVc Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

简介

云闪付(银联手机控件) cordova 插件 展开 收起
Objective-C 等 3 种语言
ISC
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
1
https://gitee.com/lantutech/lantu-union-pay.git
git@gitee.com:lantutech/lantu-union-pay.git
lantutech
lantu-union-pay
lantu-union-pay
master

搜索帮助