react-native-china-unionpay

本插件参考 银联官方 - 手机支付控件（含安卓Pay）文档。

安装

React Native 0.60 或以上

yarn add react-native-china-unionpay
cd ios && pod install # for iOS

React Native 0.59 以下

yarn add react-native-china-unionpay
react-native link react-native-china-unionpay

iOS 配置

• 在工程 info.plist 设置中添加一个 URL Types 回调协议，用于在支付完成后返回商户客户端。请注意 URL Schemes 需要是唯一的。

• http 请求设置(ats)

在测试环境测试时，需要在工程对应的 plist 文件中添加 NSAppTransportSecurity Dictionary 并同时设置里面NSAllowsArbitraryLoads 属性值为 YES，具体设置可参 照以下截图:

• 添加协议白名单

在 Xcode7.0 之后的版本中进行开发，需要在工程对应的 plist 文件中，添加 LSApplicationQueriesSchemes Array 并加入 uppaysdk、uppaywallet、uppayx1、 uppayx2、uppayx3 五个 item，具体设置可参考以下截图：

<key>LSApplicationQueriesSchemes</key>
<array>
    <string>uppaysdk</string>
    <string>uppaywallet</string>
    <string>uppayx1</string>
    <string>uppayx2</string>
    <string>uppayx3</string>
</array>

• AppDelegate.m 的 下面 @end 前面添加下面代码

// iOS 9.x or newer
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
  return [RCTLinkingManager application:application openURL:url options:options];
}

// iOS 8.x or older
- (BOOL)application:(UIApplication *)application openURL:(NSURL *)url sourceApplication:(NSString *)sourceApplication annotation:(id)annotation
{
  return [RCTLinkingManager application:application openURL:url sourceApplication:sourceApplication annotation:annotation];
}

使用

import {Unionpay, UnionpayEmitter, UNIONPAY_MODAL_PRODUCTION, UNIONPAY_MODAL_DEVELOPMENT} from 'react-native-china-unionpay';

Api

| Method | Return Type | iOS | Android | | ----------------------------------------------------------------- | ------------------- | :--: | :-----: | | startPay(tn: string, mode: string) | void | ✅ | ✅ | | startSEPay(tn: string, mode: string, seType: string) | void | ❌ | ✅ | | getSEPayInfo() | Promise<object> | ❌ | ✅ | | checkWalletInstalled() | Promise<boolean> | ❌ | ✅ | | isPaymentAppInstalled() | Promise<boolean> | ✅ | ❌ |

startPay(tn: string, mode: string)

tn - 交易流水号

mode - 连接环境："00" - 银联正式环境 "01" - 银联测试环境，该环境中不发生真实交易

通过银联工具类启动支付插件，支付结果在 UnionpayEmitter 事件中获取。

Examples

Unionpay.startPay(tn, UNIONPAY_MODAL_DEVELOPMENT);

startSEPay(tn: string, mode: string, seType: string)

tn - 交易流水号

mode - 连接环境："00" - 银联正式环境 "01" - 银联测试环境，该环境中不发生真实交易

seType - 手机pay支付类别

调用指定手机Pay支付接口（startSEPay()）之前，需要先调用检查手机Pay状态接口（getSEPayInfo()）获取seType，startSEPay()调用方式同startPay()。

Examples

Unionpay.startSEPay(tn, UNIONPAY_MODAL_DEVELOPMENT, seType);

getSEPayInfo()

检查手机 Pay 状态接口

Examples

Unionpay.getSEPayInfo().then(data => {
    console.log(data);
}).catch(error => {
    console.log(error.message);
});

checkWalletInstalled()

检测是否已安装云闪付客户端接口调用

Examples

Unionpay.checkWalletInstalled().then(data => {
    console.log(data);
}).catch(error => {
    console.log(error.message);
});

isPaymentAppInstalled()

检测是否已安装银联 App 接口调用

Examples

Unionpay.isPaymentAppInstalled().then(data => {
    console.log(data);
});

UnionpayEmitter

用于支付结果的事件订阅。支付结果的 pay_result 参数有3个选项：

• success 支付成功
• fail 支付失败
• cancel 用户取消了支付

Examples

export default class App extends Component {
    constructor(props) {
        super(props);
        this.onUnionPayResponse = this._onUnionPayResponse.bind(this);
    }

    componentDidMount() {
        UnionpayEmitter.on("UnionPayResponse", this.onUnionPayResponse);
    }

    componentWillUnmount() {
        this.isMount = false;
        UnionpayEmitter.removeListener('UnionPayResponse', this.onUnionPayResponse);
    }

    _onUnionPayResponse(data) {
        console.log(data);
    }
}

mode 常量

连接环境，有2个常量选项

• UNIONPAY_MODAL_PRODUCTION 银联正式环境
• UNIONPAY_MODAL_DEVELOPMENT 银联测试环境，该环境中不发生真实交易

测试账号

参考官网 测试环境的测试卡信息 测试卡信息-前台类交易

招商银行借记卡：6226090000000048
    手机号：18100000000
    密码：111101
    短信验证码：111111（先点获取验证码之后再输入）
    证件类型：01
    证件号：510265790128303
    姓名：张三

华夏银行贷记卡：6226388000000095
    手机号：18100000000
    cvn2：248
    有效期：1225（后台接口注意格式YYMM需倒一下）
    短信验证码：111111（先点获取验证码之后再输入）
    证件类型：01
    证件号：510265790128303
    姓名：张三

平安银行借记卡：6216261000000000018
    手机号：13552535506
    证件类型：01
    证件号：341126197709218366
    密码：123456
    姓名：全渠道
    短信验证码：111111（先点获取验证码之后再输入）

平安银行贷记卡：6221558812340000
    手机号：13552535506
    cvn2：123
    有效期：1123（后台接口注意格式YYMM需倒一下）
    短信验证码：111111（先点获取验证码之后再输入）
    姓名：互联网
    证件类型：01
    证件号：341126197709218366

农行贷记卡：5200831111111113
    手机号：13552535506
    cvn2：123
    有效期：1125（后台接口注意格式YYMM需倒一下）
    短信验证码：111111（先点获取验证码之后再输入）
    姓名：全渠道
    证件类型：01
    身份证号：341126197709218366

平安银行贷记卡：6221558812340013（信用卡还款被还款信用卡）
    手机号：13552535506
    cvn2：123
    有效期：1123（后台接口注意格式YYMM需倒一下）
    短信验证码：111111（先点获取验证码之后再输入）
    姓名：全渠道
    证件类型：01
    证件号：341126197709218366

示例

• 参考 example
• 安卓手机也可以直接安装已编译的 apk