二维码支付
查看产品
更新时间:2023-07-14
交易状态查询接口

接口描述
对于未收到交易结果的联机交易,商户应向银联全渠道支付平台发起交易状态查询交易,查询交易结果。完成交易的过程不需要同持卡人交互,属于后台交易。交易查询类交易可由商户通过SDK向银联全渠道支付交易平台发起交易。

请求方式
POST

生产调用地址
https://gateway.95516.com/gateway/api/backTransReq.do

测试调用地址
https://101.231.204.80:5000/gateway/api/backTransReq.do

请求参数
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
编码方式 |
encoding |
ANS1..20 |
UTF-8 |
M-必填
|
默认取值:UTF-8
|
|
签名 |
signature |
ANS1..1024 |
0 |
M-必填
|
填写对报文摘要的签名
|
|
产品类型 |
bizType |
N6 |
无 |
M-必填
|
|
|
接入类型 |
accessType |
N1 |
无 |
M-必填
|
0:普通商户直连接入 2:平台类商户接入
|
|
商户代码 |
merId |
AN15 |
无 |
M-必填
|
|
|
商户订单号 |
orderId |
AN8..40 |
无 |
M-必填
|
|
|
订单发送时间 |
txnTime |
YYYYMMDDhhmmss |
无 |
M-必填
|
|
|
保留域 |
reserved |
ANS1..2048 |
无 |
O-选填
|
查看详情
|
|
签名方法 |
signMethod |
N2 |
无 |
M-必填
|
非对称签名:
01(表示采用RSA签名)
HASH表示散列算法
11:支持散列方式验证SHA-256
12:支持散列方式验证SM3
|
|
交易类型 |
txnType |
N2 |
无 |
M-必填
|
交易类型:00
|
|
交易子类 |
txnSubType |
N2 |
无 |
M-必填
|
默认:00
|
|
证书ID |
certId |
N1..128 |
无 |
M-必填
|
|
|
版本号 |
version |
NS5 |
无 |
M-必填
|
固定填写
|
|
控制规则 |
ctrlRule |
N32 |
无 |
O-选填
|
32位01字符串控制位, 从左至右第五位取值为1时表示不返signPubKeyCert字段
|

应答报文(同步应答)
|
中文名称 |
英文名称 |
域类型 |
默认值 |
请求要求 |
备注 |
|
编码方式 |
encoding |
ANS1..20 |
UTF-8 |
R-需要返回 |
|
|
签名 |
signature |
ANS1..1024 |
0 |
M-必填 |
|
|
接入类型 |
accessType |
N1 |
无 |
R-需要返回 |
|
|
商户代码 |
merId |
AN15 |
无 |
R-需要返回 |
|
|
商户订单号 |
orderId |
AN8..40 |
无 |
R-需要返回 |
被查询交易的订单号 |
|
订单发送时间 |
txnTime |
YYYYMMDDhhmmss |
无 |
R-需要返回 |
被查询交易的交易时间 |
|
支付方式 |
payType |
N4 |
无 |
C-按条件必填 |
(消费、预授权)根据商户配置返回 |
|
交易币种 |
currencyCode |
AN3 |
无 |
C-按条件必填 |
|
|
账号 |
accNo |
AN1..1024 |
无 |
C-按条件必填 |
根据商户配置返回 |
|
支付卡类型 |
payCardType |
N2 |
无 |
C-按条件必填 |
(消费、预授权)根据商户配置返回 |
|
交易金额 |
txnAmt |
N1..12 |
无 |
C-按条件必填 |
|
|
保留域 |
reserved |
ANS1..2048 |
无 |
O-选填 |
查看详情 |
|
发卡机构识别模式 |
issuerIdentifyMode |
N1 |
无 |
C-按条件必填 |
消费、预授权交易返回 |
|
查询流水号 |
queryId |
AN20..21 |
无 |
M-必填 |
被查询交易查询流水号 |
|
系统跟踪号 |
traceNo |
N6 |
无 |
M-必填 |
统一返回 |
|
交易传输时间 |
traceTime |
MMDDhhmmss |
无 |
M-必填 |
统一返回 |
|
清算日期 |
settleDate |
MMDD |
无 |
M-必填 |
资金类交易统一返回 |
|
清算币种 |
settleCurrencyCode |
AN3 |
无 |
M-必填 |
资金类交易统一返回 |
|
清算金额 |
settleAmt |
N1..12 |
无 |
M-必填 |
资金类交易统一返回 |
|
清算汇率 |
exchangeRate |
N8 |
无 |
C-按条件必填 |
交易成功,交易币种和清算币种不一致的时候返回 |
|
兑换日期 |
exchangeDate |
MMDD |
无 |
C-按条件必填 |
交易成功,交易币种和清算币种不一致的时候返回 |
|
原交易应答码 |
origRespCode |
AN2 |
无 |
C-按条件必填 |
查询交易成功时返回 |
|
原交易应答信息 |
origRespMsg |
ANS1..256 |
无 |
C-按条件必填 |
|
|
应答码 |
respCode |
AN2 |
无 |
M-必填 |
|
|
应答信息 |
respMsg |
ANS1..256 |
无 |
M-必填 |
|
|
签名方法 |
signMethod |
N2 |
无 |
M-必填 |
|
|
签名公钥证书 |
signPubKeyCert |
AN2048 |
无 |
C-按条件必填 |
使用RSA签名方式时必选,此域填写银联签名公钥证书。 |
|
交易类型 |
txnType |
N2 |
无 |
M-必填 |
同被查询交易 |
|
交易子类 |
txnSubType |
N2 |
无 |
M-必填 |
同被查询交易 |
|
请求方保留域 |
reqReserved |
ANS1..1024 |
无 |
O-选填 |
返回被查询交易的请求方保留域 |
|
版本号 |
version |
NS5 |
无 |
R-需要返回 |
|
|
订单优惠信息 |
issAddnData |
ANS1..8000 |
|
O-选填 |
查看详情 |

异常应答说明
1. 不返回报文体的情况:
版本号,交易类型、子类,签名方法,签名值等关键域未上送,返回“Invalid request.”;
交易类型和请求地址校验有误,返回“Invalid request URI.”
2. 返回全部的请求报文,附加应答码和应答描述(包括的应答码有:01、02、03、10、11、32):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常