中国银联开放平台

文档中心

接口列表

手机网页支付（WAP支付）

消费接口

消费撤销接口

退货接口

交易状态查询接口

银联加密公钥更新查询接口

预授权接口

预授权撤销

预授权完成

预授权完成撤销

文件传输接口

手机网页支付（WAP支付）

查看产品

更新时间：2021-09-24

交易状态查询接口

接口描述

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

请求方式

POST

生产调用地址

https://gateway.95516.com/gateway/api/backTransReq.do

测试调用地址

https://101.231.204.80:5000/gateway/api/backTransReq.do

请求参数

中文名称	英文名称	域类型	默认值	请求要求	备注
版本号	version	NS5	无	M-必填	固定填写5.1.0
编码方式	encoding	ANS1..20	UTF-8	M-必填	默认取值：UTF-8
产品类型	bizType	N6	无	M-必填
订单发送时间	txnTime	YYYYMMDDhhmmss	无	M-必填
交易类型	txnType	N2	无	M-必填	交易类型：00
交易子类	txnSubType	N2	无	M-必填	默认：00
接入类型	accessType	N1	无	M-必填	0：商户直连接入 1：收单机构接入 2：平台商户接入
签名	signature	ANS1..1024	0	M-必填	填写对报文摘要的签名
签名方法	signMethod	N2	无	M-必填	非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3
商户代码	merId	AN15	无	M-必填
商户订单号	orderId	AN8..40	无	M-必填	商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。
证书ID	certId	N1..128	无	M-必填
签名公钥证书	signPubKeyCert	AN1..2048	无	C-按条件必填	此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。
收单机构代码	acqInsCode	AN8..11	无	C-按条件必填	接入类型为收单机构接入时需上送
保留域	reserved	ANS1..2048	无	O-选填	查看详情

应答报文（同步应答）

中文名称	英文名称	域类型	默认值	请求要求	备注
查询流水号	queryId	AN20..21	无	M-必填	被查询交易查询流水号
交易传输时间	traceTime	MMDDhhmmss	无	M-必填	统一返回
交易类型	txnType	N2	无	M-必填	同被查询交易
交易子类	txnSubType	N2	无	M-必填	同被查询交易
签名	signature	ANS1..1024	0	M-必填
签名方法	signMethod	N2	无	M-必填
清算币种	settleCurrencyCode	AN3	无	M-必填	资金类交易统一返回
清算金额	settleAmt	N1..12	无	M-必填	资金类交易统一返回
清算日期	settleDate	MMDD	无	M-必填	资金类交易统一返回
系统跟踪号	traceNo	N6	无	M-必填	统一返回
应答码	respCode	AN2	无	M-必填
应答信息	respMsg	ANS1..256	无	M-必填
绑定标识号	bindId	ANS1..128	无	C-按条件必填	绑定支付时，根据商户配置返回
兑换日期	exchangeDate	MMDD	无	C-按条件必填	交易成功，交易币种和清算币种不一致的时候返回
发卡机构识别模式	issuerIdentifyMode	N1	无	C-按条件必填	消费、预授权交易返回
交易币种	currencyCode	AN3	无	C-按条件必填
交易金额	txnAmt	N1..12	无	C-按条件必填
签名公钥证书	signPubKeyCert	AN1..2048	无	C-按条件必填	此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。
清算汇率	exchangeRate	N8	无	C-按条件必填	交易成功，交易币种和清算币种不一致的时候返回
收单机构代码	acqInsCode	AN8..11	无	C-按条件必填	接入类型为收单机构接入时需上送
有卡交易信息域	cardTransData	ANS1Trans	无	C-按条件必填	查看详情
原交易应答码	origRespCode	AN2	无	C-按条件必填	查询交易成功时返回
原交易应答信息	origRespMsg	ANS1..256	无	C-按条件必填
账号	accNo	AN1..1024	无	C-按条件必填	根据商户配置返回
支付方式	payType	N4	无	C-按条件必填	（消费、预授权）根据商户配置返回
支付卡标识	payCardNo	ANS1..19	无	C-按条件必填	（移动支付消费）根据商户配置返回
支付卡类型	payCardType	N2	无	C-按条件必填	（消费、预授权）根据商户配置返回
支付卡名称	payCardIssueName	ANS1..64	无	C-按条件必填	（移动支付消费）根据商户配置返回
版本号	version	NS5	无	R-需要返回	固定填写5.1.0
编码方式	encoding	ANS1..20	UTF-8	R-需要返回
订单发送时间	txnTime	YYYYMMDDhhmmss	无	R-需要返回	被查询交易的交易时间
接入类型	accessType	N1	无	R-需要返回	0：商户直连接入 1：收单机构接入 2：平台商户接入
商户代码	merId	AN15	无	R-需要返回
商户订单号	orderId	AN8..40	无	R-需要返回	商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。
保留域	reserved	ANS1..2048	无	O-选填	查看详情
请求方保留域	reqReserved	ANS1..1024	无	O-选填	返回被查询交易的请求方保留域

异常应答说明

1. 不返回报文体的情况：
版本号，交易类型、子类，签名方法，签名值等关键域未上送，返回“Invalid request.”；
交易类型和请求地址校验有误，返回“Invalid request URI.”

2. 返回全部的请求报文，附加应答码和应答描述（包括的应答码有：01、02、03、10、11、32）：
验证签名失败；
报文格式错（包含，必填域缺失，上送银联报文未定义的域，报文域的格式非法，交易时间超出范围）；
签名失败；
超时等其他系统异常

提示信息

提示