银联线上收银台直通模式接入指南及列表
银联线上收银台直通模式说明
一、 Android ( 3.5.11 及以上版本支持)
upmp_android/UPPayAssistEx.jar中定义了检测用户安装银联支付 APP 列表的
接口, 接口定义如下:
void getDirectApps(Context context, String mode, String merchantInfo, IUnionCallbackcallback)
1. 接口说明
该接口用于检测用户手机上装有哪些可用于直通模式的银联支付 APP,当用户手机上安装有 可用于直通模式的 APP,该接口会异步返回这些可用 APP 的英文简称列表。
2. 接口参数
名称 | 类型 | 是否可选 | 说明 |
---|---|---|---|
context | Context | 必填 | |
mode | String | 选填 | 银联后台环境标识, 00:生产环境, 01: PM 环境,默认值为 00 |
merchantInfo | String | 选填 | 商户号(银联商户号) |
callback | IUnionCallback | 必填 | 回调数据 |
IUnionCallback 定义如下:
public interface IUnionCallback
{
void onResult(Bundle result);
void onError(String code,String msg);
}
3. result 中参数说明
参数 | 字段 | 类型 | 说明 |
---|---|---|---|
直通可用 app列表 | directApps | List<Sting> | 直通可用 app 英文简称列表;云闪付名称:CQP 支持银行详情请查询云闪付APP线上收银台支持银行列表 |
4. code, msg 说明
参数 | 字段 | 类型 | 说明 |
---|---|---|---|
错误码 | code | String | 参数错误 : 01 网络错误 : 02 其它 : 03 |
错误信息 | msg | String | 参数错误 : parameter error 网络错误 : network error 其它 : unknown error |
5. 域名
请确保添加以下域名:
cn : https://acpstatic.cup.com.cn
com : https://acpstatic.95516.com
二、 IOS ( 3.4.9 及以上版本支持)
接口定义如下:
- (void)getDirectApps:(NSString)mode
withMerchantInfo:(NSString)merchantInfo
succBlock:(UPPaymentDirectAppSucc)succBlock
failBlock:(UPPaymentDirectAppFail)failBlock;
1. 接口说明
该接口用于检测用户手机上装有哪些可用于直通模式的银联支付 APP,当用户手机上安装有 可用于直通模式的 APP,该接口会异步返回这些可用 APP 的英文简称列表。
2. 接口参数
名称 | 类型 | 是否可选 | 说明 |
---|---|---|---|
mode | NSString | 选填 | 银联后台环境标识, 00:生产环境, 01:PM 环境,默认值为 00 |
merchantInfo | NSString | 选填 | 商户号(银联商户号) |
succBlock | NSBlock | 必填 | 成功回调 |
failBlock | NSBlock | 必填 | 失败回调 |
3. 成功回调
typedef void (^UPPaymentDirectAppSucc)(NSArray* directApps);
参数 | 字段 | 类型 | 说明 |
---|---|---|---|
直通可用app | directApps | NSArray | 直通可用 app 英文简称列表 云闪付名称:CQP; 支持银行详情请查询云闪付APP线上收银台直通模式说明 |
4. 失败回调
typedef void (^UPPaymentDirectAppFail)(NSString* code,NSString* msg);
参数 | 字段 | 类型 | 说明 |
---|---|---|---|
错误码 | code | NSString | 参数错误 : 01 网络错误 : 02 其它 : 03 |
错误信息 | msg | NSString | 参数错误 : parameter error 网络错误 : network error 其它 : unknown error |
5. 域名
请确保添加以下域名:
cn : https://acpstatic.cup.com.cn
com : https://acpstatic.95516.com
三、后台接口
直接跳转云闪付,需要在接口文档中的字段中:
子域名 | 标识 | 子域格式 | 说明 |
---|---|---|---|
统一收银台直通模式的银行标识 | ebankEnAbbr | ANS..40 | 该值为统一收银台直通模式业务下,直通银行的英文简称。如果 商 户选择直接拉起特定银行 APP,必须上送此要素。云闪付必须上送;CQP 支持银行详情请查询云闪付APP线上收银台直通模式说明 |
个人网关类别 | ebankType | N2 | 01:APP+H5 02:APP 03:H5 在银联线上收银台直通模式业务下, 商户可以选择银行 APP 调用的方式(取值只能为 01、02 或者 03); 如果商户未上送取值,默认取值 01。 商户上送此字段时,必须上送“统一收银台直通模式的银行标识”字段,否则将拒绝交易。 |
云闪付APP线上收银台直通模式支持银行列表
序号 | APP中文名称 | 银行简码(直通模式用) |
---|---|---|
1 | 银联云闪付 | CQP |
2 | 中国工商银行 | ICBC |
3 | 工银e生活 | ICBCC |
4 | 中国农业银行 | ABC |
5 | 中国银行缤纷生活 | BOCC |
6 | 中国建设银行 | CCB |
7 | 交通银行 | BoCom |
8 | 买单吧 | BoComC |
9 | 中信银行手机银行 | CNCB |
10 | 动卡空间 | CNCBC |
11 | 光大银行手机银行 | CEB |
12 | 招商银行 | CMB |
13 | 掌上生活 | CMBLIFE |
14 | 浦发银行 | SPDB |
15 | 浦大喜奔 | SPDBC |
16 | 民生银行手机银行 | CMBC |
17 | 全民生活 | CMBCC |
18 | 平安口袋银行 | PAB |
19 | 兴业银行手机银行 | CIB |
20 | 兴业生活(好兴动) | CIBC |
21 | 发现精彩 | GDBC |
22 | 华夏手机银行 | HXB |
23 | 京彩生活 | BCCB |
24 | 掌上京彩 | BCCBC |
25 | 上海银行手机银行 | BOS |
26 | 上银美好生活 | SHBANK |
27 | 华彩生活 | HXBC |
28 | 浙商银行 | CZBANK |
29 | 兰州银行 | LZBANK |
30 | 宁波银行 | BNB |
31 | 大连农商银行 | DLRCB |
最后编辑:xiaofeng 更新时间:2025-04-29 15:45