交易自助诊断服务

数据 收单机构 发卡机构 快速接入
根据商户号或者卡号,查询一段时间内的银联生产交易列表和详情,并可以根据应答码等信息快速定位问题。

接入服务商:银联开放平台

API ID:332

接口状态:正常

业务申请
暂不支持测试

接口名称

获取token

接口描述

产品token是开放平台每个产品的全局唯一接口调用凭据,用户调用各接口时都需使用产品token。

接口地址

测试地址: 敬请期待


生产地址: https://openapi.unionpay.com/upapi/adTrans/token

请求方式

HTTP GET

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
用户唯一凭证 app_id string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证账号”中查看
用户唯一凭证密钥 app_secret string M-必填 详情可在登录开放平台后“个人中心-我的信息-API认证信息-API认证密钥”中查看

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 获取到的凭证; 凭证是字符串
过期时间 expire_in long M-必填 凭证有效时间,单位:秒

接口名称

交易列表信息

接口描述

查询当前机构一段时间内的交易列表信息

接口地址

测试地址: 敬请期待


生产地址: https://openapi.unionpay.com/upapi/adTrans/list

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts long M-必填 单位:毫秒,对于Java一般使用System.currentTimeMillis();获取。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 32 M-必填 必须为开放平台登录机构号
系统标识 sysCode string 2 M-必填 01-银联cups系统
起始日期 beginDate string 8 M-必填 必填 < YYYYMMDD >
结束日期 endDate string 8 M-必填 必填 < YYYYMMDD > ;起始日期或之后日期,时间间隔不超过1个月
卡号 cardNo string 32 M-必填 银联系统中的银行卡号\虚拟卡号\token卡号
商户代码 mchntCd string 32 M-必填 商户代码与卡号至少二选一
分页页码 page int M-必填 每页仅固定返回50条数据

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 128 M-必填
响应数据 data array M-必填 列表数据,每页大小50
交易id logId string 30 M-必填 数据唯一主键
交易卡号 cardNo string 20 M-必填 前六后四脱敏数据
交易代码 transId string 8 M-必填
系统跟踪号 sysTraNo string 6 M-必填
商户代码 mchntCd string 15 M-必填
交易时间 transTm string 14 M-必填 YYYYMMDDHHMMSS
交易金额 transAt string 12 M-必填 人民币,单位为分
交易状态 transSt string 2 M-必填 详情请见《交易状态详情表》

接口名称

交易诊断详情信息

接口描述

查询当前机构具体一笔的交易详情信息

接口地址

测试地址: 敬请期待


生产地址: https://openapi.unionpay.com/upapi/adTrans/detail

请求方式

HTTP POST

请求url参数

名称 标识 字段类型 长度 请求要求 默认值 备注
产品token token string M-必填 详情请参考“获取token”接口中应答参数“token”的具体数据。
签名信息 sign string M-必填 详细签名算法可参考“接入指南”板块第3条。
时间戳 ts int M-必填 单位:毫秒;对于Java一般使用System.currentTimeMillis();获取。

请求报文体参数

名称 标识 字段类型 长度 请求要求 默认值 备注
机构代码 insIdCd string 32 M-必填 必须为开放平台登录机构号
交易id logId string 30 M-必填
系统标识 sysCode string 2 M-必填 01-银联cups系统;

应答参数

名称 标识 字段类型 长度 请求要求 默认值 备注
响应编号 respCd string 4 M-必填
响应信息 respMsg string 128 M-必填
相应数据 data map M-必填 交易诊断详情数据
发送机构 fwdInsIdCd string 10 M-必填
受理机构 acqInsIdCd string 10 M-必填
发卡机构 issInsIdCd string 10 M-必填
接收机构 rcvInsIdCd string 10 M-必填
相关机构 relatedInsIdCd string 10 M-必填
服务点输入方式 posEntryMdCd string 3 M-必填
商户代码 mchntCd string 15 M-必填
交易商户名称 mchntnm string 40 M-必填
商户类型 mchntTp string 4 M-必填
终端号 termId string 10 M-必填
交易渠道 transChnl string 2 M-必填 00--未知;01--自动柜员机(含ATM和CDM);02--保留使用;03--有线销售点终端(POS);04--保留使用;05--多媒体终端;06--银行柜台和柜面;07--个人电脑;08--手机设备;09--I型固定电话;10--保留使用;11--无线销售点终端(移动POS);12--中国银联公共服务平台;13--农民工银行卡特色服务;14--商户系统;15--第三方机构系统;16--数字机顶盒;17--II型固定电话;18--保留使用;19--保留使用;20--批量文件处理系统;21--保留使用;22--音频刷卡支付终端(VI-POS);23--mPOS
交易代码 transId string 3 M-必填 详情请见《交易代码详情表》
交易金额 tranAt string 12 M-必填
交易币种 transCurrCd string 3 M-必填
HCE产品名称 extHceProdNm string 1 M-必填 0-缺省;1-Applepay;2-Hce;3-三星mst;4-三星IC;5-华为pay;6-小米pay;a-SWP-SIM卡支付;b-蓝牙标准卡支付;c-蓝牙挂件卡支付;d-蓝牙手表支付;e-蓝牙手环支付;Y-二维码主扫;Z-二维码被扫
卡性质 cardAttr string 2 M-必填 00--未知;01--借记卡;02--贷记卡;03--准贷记卡;04--借贷合一卡;05--预付费卡;06--半开放式预付费卡;07--**;99--单用途预付费卡
发卡方应答码 respCd1 string 2 M-必填
转换发卡方应答码 respCd2 string 2 M-必填
受理方应答码 respCd4 string 2 M-必填
转换受理方应答码 respCd3 string 2 M-必填
卡种 cardClass string M-必填
交易介质 transMedia string M-必填
服务点条件代码 posCondCd string M-必填
是否小额免密 noPasswdFlag string 1 M-必填 0-否;1-是
是否跨境 crossDisIn string 1 M-必填 0-境内;1-人民币境外;2-外卡收单;3-国际卡发卡
授权标识应答码 authIdRespCd string 6 M-必填
非标标识 nonStandardFlag string 1 M-必填
扩展信息 extendInf string 512 M-必填
是否异地 transMd string 1 M-必填
特殊计费类型 speChgTp string 2 M-必填
特殊计费档次 speChgLvl string 1 M-必填
总手续费收取标记 discIn string 1 M-必填
总手续费 totalDiscAt string 20 M-必填
发送方清算金额 fwdSettleAt string 20 M-必填
发送方清算币种 fwdSettleCurrCd string 3 M-必填
接收方清算金额 rcvSettleAt string 20 M-必填
接收方清算币种 rcvSettleCurrCd string 3 M-必填
无卡交易类型 wTransType string 4 M-必填
无卡业务种类 wBussType string 6 M-必填
无卡持卡人账户等级 wAcctLevel string 1 M-必填
收付标识 wCollPayFlag string 1 M-必填
无卡签约协议号 wProtocolCd string 34 M-必填
无卡订单号 wOrderId string 40 M-必填
无卡系统返回码 wSysRespCd string 8 M-必填
无卡系统返回说明 wSysRespDesc string 64 M-必填
交易id logId string 30 M-必填 数据唯一主键
交易卡号 cardNo string 20 M-必填 前六后四脱敏数据
交易状态 transSt string 2 M-必填 详情请见《交易状态详情表》
清算日期 settleDt string 8 M-必填 YYYYMMDD
传输日期和时间 tfrDtTm string 10 M-必填 MM-DD HH:MM:SS
Token号 extTokenNo string 20 M-必填
转入卡号 tfrInAcctNo string 20 M-必填
转出卡号 tfrOutAcctNo string 20 M-必填
系统追踪号 sysTraNo string 6 M-必填
检索参考号 retriRefNo string 12 M-必填
原始系统追踪号 origSysTraNo string 6 M-必填
是否清算 stiTakeoutIn string 1 M-必填 0-否;1-是
产品详情

机构可根据金融交易的商户号或者卡号,查询机构自身在指定时间内的生产交易详细记录,包含但不仅限于交易的金额、交易商户名称、发卡行、收单行等信息,并可以根据交易应答码等要素定位交易失败原因。

3.png


立即体验 》》

应用场景

机构经过银联转接的交易数据均可以提供给合作伙伴查询。可应用在机构快速查询交易明细、自主定位交易失败原因等场景。

应用对象

机构用户

接入流程

1、目前该产品API仅面向机构用户提供服务,如有相关需求,请联系业务接口人说明相关使用需求;

2、机构用户请提供相关材料业务接口人进行评估确认;

3、如需调用该API,请点击右上角“业务申请”,并认真填写相关内容,待业务接口人审核通过后即可(审核周期为2-3个工作日);

4、技术联调,可参《“快速接入”产品API指南-接入指南》


应答码参照:
应答码 描述
0000 处理成功。
1001 此处根据实际系统进行编排
9901 您的IP(XXX.XXX.XXX.XXX)没有登记,请登录银联开放平台(open.unionpay.com)进行白名单登记。
9902 您的IP(XXX.XXX.XXX.XXX)已被限制访问,请登录银联开放平台(open.unionpay.com)提交申诉请求。
9903 您的IP(XXX.XXX.XXX.XXX)请求过于频繁,已被临时限制,请5分钟后再尝试。
9904 您的 IP(XXX.XXX.XXX.XXX)不属于你设置的开发IP列表,请登录银联开放平台(open.unionpay.com)确认相关配置
9905 请求参数值有误,请确认请求参数信息
9906 您的账号不具备当前产品请求权限,如有权限,可重新获取该产品Token后再尝试。
9907 app_id与app_secret验证失败
9908 您的Token已过期,请重新获取Token。
9909 您的Token信息非最新Token,请确保您的系统中使用的是最新的Token值。
9910 您的签名密钥未设置,请登录银联开放平台(open.unionpay.com)确认相关配置
9911 您的签名信息验证不通过,请检查您的签名实现是否符合银联开放平台(open.unionpay.com)提供的签名规则。
9912 您的报文格式有误,要求报文符合JSON数据格式
9913 你的报文数据有误,未通过数据信息校验,具体原因视业务需求
9914 您的报文无法解密,请检查您在银联开放平台(open.unionpay.com)上提供的RSA公钥是否正确。
9917 您的账号不具备当前产品API请求权限,请联系相关业务接口人。
9991 银联开放平台系统内部错误:产品服务调用失败
9992 银联开放平台系统内部错误:产品服务系统未知错误
9993 银联开放平台系统内部错误:产品服务未注册至服务中心
9994 银联开放平台系统内部错误:产品服务参数错误

1.获取产品调用token信息


1.1JSON 报文举例

请求URL

https://openapi.unionpay.com/upapi/adTrans/token?app_id=[app_id]&app_secret=[app_secret]

请求报文参数

本次请求为GET请求,无请求报文参数

应答报文结果

{
    "token": "MYkJ2QghSnhE-tn27KRpyZqtPrXyzrz9r0kNiA0JmAFJy-sQLPwVl__TAr
    EiM5BAF5X-esHVz0ez1iuGKbMbdp-AElFNRzc8t2OcUGTm7WXxZH0BJkQJe3ZubPgA2kEd",
    "respMsg": "成功",
    "expire_in": 7200,
    "respCd": "0000"
}

2.交易列表信息

2.1JSON 报文举例

请求URL

https://openapi.unionpay.com/upapi/adTrans/list?token=[token]&sign=[sign]&ts=[ts]

请求报文参数

{
    "cardNo": "6228480329290612673",
    "insIdCd": "48679202",
    "sysCode": "01",
    "beginDate": "20170904",
    "endDate": "20170904"
}

应答报文结果

{
    "data": [{
        "sysTraNo": "393689",
        "cardNo": "622848*********2673",
        "transSt": "00",
        "logId": "SWT017090415120910255870092628",
        "transId": "W20",
        "transTm": "20170904151209",
        "transAt": "1",
        "mchntCd": "000000048679202"
    }],
    "respCd": "0000",
    "respMsg": "SUCCESS"
}

3. 交易诊断详情信息

3.1JSON 报文举例

请求URL

https://openapi.unionpay.com/upapi/adTrans/detail?token=[token]&sign=[sign]&ts=[ts]

请求报文参数

{
    "insIdCd": "00092400",
    "logId": "PA0017101007251000092400277115",
    "sysCode": "01"
}

应答报文结果

{
   "respCd": "0000",
   "respMsg": "", 
   "data": {
       "logId": "PA0017101007251000092400277115",
        ……
        }
}



1. “快速接入”产品API使用教程请参考在线文档:

《“快速接入”产品API指南—接入指南》


2. “快速接入”产品API安全调用过程请参考在线文档:

2.1《“快速接入”产品API指南—获取产品token》

2.2《“快速接入”产品API指南—产品功能接口调用》


3. “快速接入”产品API接口调用报文签名样例请参考在线文档:

《“快速接入”产品API指南—报文签名样例代码》


4. “快速接入”产品API测试工具使用说明请参考在线文档:

《“快速接入”产品API指南—“快速接入”测试工具》


序号

代码

交易状态

1

00

成功

2

01

查发卡方

3

03

无效商户

4

04

没收卡

5

05

身份认证失败

6

10

部分金额批准

7

11

重要人物批准(VIP

8

12

无效的关联交易

9

13

无效金额

10

14

无效卡号(无此账号)

11

15

找不到发卡方

12

16

批准更新第三磁道

13

21

卡未初始化

14

22

故障怀疑,关联交易错误

15

25

找不到原交易

16

30

报文格式错误

17

34

有作弊嫌疑

18

38

超过允许的PIN试输入

19

40

机构权限检查失败

20

41

挂失卡

21

43

被窃卡

22

51

资金不足

23

54

过期的卡

24

55

不正确的PIN

25

57

bin不可用

26

58

不允许终端进行的交易

27

59

有作弊嫌疑

28

61

金额超限

29

62

受限制的卡

30

64

原始金额错误

31

65

超出取款/消费次数限制

32

68

发卡行响应超时

33

75

允许的输入PIN次数超限

34

90

正在日终处理()

35

91

发卡方不能操作

36

92

金融机构或中间网络设施找不到或无法达到

37

94

重复交易

38

96

代授权期间发卡返

39

96

处理中心异常

40

97

ATM/POS终端号找不到

41

98

银联处理中心收不到发卡方应答

42

99

PIN格式错误

43

A0

MAC校验错

44

A1

转账货币不一致

45

A2

有缺陷的成功

46

A3

资金到账行无此账户

47

A4

有缺陷的成功

48

A5

有缺陷的成功

49

A6

有缺陷的成功

50

A7

安全处理失败

51

A8

转入卡归属地信息缺失

52

B1

无欠费(收据未打

53

C1

受理方状态非法

54

D1

机构代码错误

55

D2

日期错误

56

D3

无效的文件类型

57

D4

已经处理过的文件

58

D5

无此文件

59

D6

接收者不支持

60

D7

文件锁定

61

D8

未成功

62

D9

文件长度不符

63

DA

文件解压缩错

64

DB

文件名称错

65

DC

无法接收文件

66

F1

文件记录格式错误

67

F2

文件记录重复

68

F3

文件记录不存在

69

F4

文件记录错误

70

F5

文件批量转联机未完成

71

N1

未登折帐目已超限,交易不成功

序号

代码

状态

1

E15

差错-转出向受理查复

2

E16

差错-受理向转入查询

3

E17

差错-转入向受理查复

4

E18

差错-PBOC IC发卡转帐圈存调单(转入)

5

E19

差错-PBOC IC发卡转帐圈存调单回复(转入)

6

E20

差错-收费

7

E22

差错-请款

8

E23

差错-结算的退单

9

E24

差错-结算再请款

10

E25

差错-结算二次退单

11

E26

差错例外协商

12

E27

差错例外协商回复

13

E28

差错-受理-调单

14

E29

差错-受理-调单回复

15

E30

差错-付费

16

E31

差错例外-贷(受理方)

17

E32

差错-贷记调整

18

E33

差错-一般转帐转入贷记调整

19

E34

一般转帐转出贷记调整

20

E35

差错-一般转帐转入对贷调请款

21

E36

差错-一般转帐转出请款

22

E37

差错-一般转账转出一次退单

23

E38

差错-一般转账转入一次退单

24

E39

差错-转入转帐对贷调请款

25

E63

差错-PBOC转帐圈存贷记调整(转入)

26

E64

差错-PBOC转帐圈存贷记调整(转出)

27

E65

差错-PBOC现金充值贷记调整

28

E66

差错-PBOC圈存贷记调整

29

E67

差错-PBOC转帐圈存一次退单(转出)

30

E68

差错-PBOC转帐圈存一次退单(转入)

31

E70

差错-转出转帐请款

32

E71

差错-受理向转出查询

33

E72

差错-转出向受理查复

34

E73

差错例外-贷(发卡方)

35

E74

退货(手工)

36

E75

差错-付费撤消

37

E77

差错-退货二次退单撤消

38

E80

差错-发卡-存款的贷记调整

39

E81

差错-发卡-请款

40

E82

差错-受理-一次退单

41

E84

退货(手工单)

42

S00

余额查询

43

S01

明细查询

44

S02

一般转账

45

S03

圈存

46

S04

圈提

47

S05

圈提确认

48

S06

建立委托关系

49

S07

撤销委托关系

50

S08

修改密码

51

S09

PBOC转账圈存

52

S10

预授权/授权

53

S11

转账还款

54

S12

追加预授权

55

S13

分期付款消费

56

S14

帐户验证(银联通汇款)

57

S15

PBOC转账圈存转出

58

S16

PBOC转账圈存转入

59

S17

帐户验证

60

S18

PBOC现金充值

61

S19

银行卡信息下载

62

S20

预授权完成

63

S21

结算通知(中心发)

64

S22

消费

65

S23

实时代收

66

S24

取现

67

S25

一般转账转出

68

S26

转账还款转出

69

S27

MDS/ATM购物

70

S28

银联通汇款(联机)

71

S29

发卡MDS预授权完成

72

S30

联机退货

73

S31

代付

74

S32

存款

75

S33

一般转账转入

76

S34

转帐还款转入

77

S35

预授权结算(机构发)

78

S36

积分消费

79

S37

联盟积分消费

80

S38

联盟积分查询

81

S39

联盟积分联机退货

82

S40

磁条卡现金充值

83

S41

账户充值转账

84

S43

充值转账转出

85

S44

充值转账转入

86

S45

脱机转联机通知

87

S46

MO/TO消费

88

S47

MO/TO退货

89

S48

MO/TO预授权

90

S49

MO/TO预授权完成

91

S50

MO/TO预授权完成通知(机构发)

92

S51

MO/TO预授权完成通知(中心发,实际不启用)

93

S54

预约消费

94

S55

建立委托

95

S56

自助消费

96

S57

自助脱机消费通知

97

S59

助农取款

98

S60

脱机退货通知

99

S64

批量代收

100

S65

自助预授权

101

S67

自助预授权完成

102

S70

预约助农无卡取款

103

S71

自助预授权完成通知(机构发)

104

S73

自助预授权完成(手工)

105

S80

预授权完成(手工)

106

S81

预授权完成(手工单)

107

S82

银联通汇款(手工)

108

S83

MO/TO预授权完成(手工)

109

S90

MC/MDS拒绝承认0290

110

S91

代付通知

111

S92

存款确认

112

S93

转入转帐确认

113

S94

转帐还款转入确认

114

S95

磁条卡现金充值确认

115

S96

充值转账转入确认

116

V13

分期付款消费撤销

117

V40

预授权/授权撤消

118

V42

授权冲撤

119

V43

BASEI发起POS授权冲撤

120

V44

BASEI发起ATM取现授权

121

V50

预授权完成撤消

122

V52

消费撤消

123

V53

实时代收撤销

124

V54

柜面取现撤消

125

V57

联盟积分消费撤销

126

V58

POSCashAdvance撤销

127

V61

代付撤消

128

V62

存款撤消

129

V63

积分消费撤消

130

V66

自助预授权撤销

131

V68

PBOC现金充值撤销

132

V69

自助预授权完成撤销

133

V73

自助预授权完成撤销(手工)

134

V76

MO/TO消费撤销

135

V78

MO/TO预授权撤销

136

V79

MO/TO预授权完成撤销

137

V81

预授权完成撤销(手工)

138

V83

MO/TO预授权完成撤销(手工)

139

V84

预约消费撤消

140

V85

撤销委托

141

V93

BASE1POS授权冲撤通知

142

V94

BASE1ATM授权冲撤通知

咨询我们
业务咨询
姓名: 王峻峄
电话: 021-38929999-6767
邮箱: wangjunyi@unionpay.com
技术咨询
姓名: 张明虎
电话: 021-20632674
邮箱: zhangminghu@unionpay.com
热门推荐