接口描述
对于未收到交易结果的联机交易，商户应向银联全渠道支付平台发起交易状态查询交易，查询交易结果。完成交易的过程不需要同持卡人交互，属于后台交易。交易查询类交易可由商户通过SDK向银联全渠道支付交易平台发起交易。
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/queryTrans.do
测试调用地址
https://gateway.test.95516.com/gateway/api/queryTrans.do
请求参数 | 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 版本号 | version | NS5 | 无 | M-必填 |
固定填写5.1.0 |
|
| 编码方式 | encoding | ANS1..20 | UTF-8 | M-必填 |
填写报文使用的字符编码 UTF-8|GBK|GB2312|GB18030 若不填写，默认取值：UTF-8 |
|
| 证书ID | certId | N1..128 | 无 | C-按条件必填 |
填写签名私钥证书的Serial Number，该值可通过银联提供的SDK获取 |
|
| 签名 | signature | ANS1..1024 | 0 | M-必填 |
填写对报文摘要的签名 |
|
| 签名方法 | signMethod | N2 | 无 | M-必填 |
非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3 |
|
| 交易类型 | txnType | N2 | 无 | M-必填 |
取值： 00：查询交易 01：消费 02：预授权 03：预授权完成 04：退货 05：圈存 11：代收 12：贷记 13：账单支付 14：转账（保留） 21：批量交易 22：批量查询 31：消费撤销 32：预授权撤销 33：预授权完成撤销 72：实名认证-建立绑定关系 73：账单查询 74：解除绑定关系 75：查询绑定关系 76：文件传输 77：发送短信验证码交易 78：开通查询交易 79：开通交易 94：IC卡脚本通知 95：查询更新加密公钥证书 |
|
| 交易子类 | txnSubType | N2 | 无 | M-必填 |
依据实际交易类型填写 00001注 默认取值：00 |
|
| 产品类型 | bizType | N6 | 无 | M-必填 |
依据实际业务场景填写(目前仅使用后4位，前面2位默认为00) 默认取值：000000 具体取值范围： 000201：B2C网关支付 000301：认证支付2.0 000302：评级支付 000401：贷记 000501：代收 000601：账单支付 000801：跨行收单 000901：绑定支付 001001：订购 00001注 000202：B2B |
|
| 接入类型 | accessType | N1 | 无 | M-必填 |
0：商户直连接入 1：收单机构接入 2：平台商户接入 |
|
| 收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 |
已被批准加入银联互联网系统的收单机构代码 |
|
| 商户代码 | merId | AN15 | 无 | M-必填 |
已被批准加入银联互联网系统的商户代码 |
|
| 商户名称 | merName | ANS1..40 | 无 | C-按条件必填 |
接入类型为收单机构接入时需上送 不支持换行符等不可见字符 |
|
| 商户英文名称 | merEnName | ANS40 | C-按条件必填 | 查看详情 | ||
| 商户订单号 | orderId | AN8..40 | 无 | M-必填 |
商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
| 订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | M-必填 |
商户发送交易时间 |
|
| 保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
| 控制规则 | ctrlRule | N32 | 无 | O-选填 |
32位01字符串控制位， 从左至右第一位取值为1表示财税库银信息控制位； 第二位取值为1时表示小微商户； 第三位取值为1时表示河北电力代缴建立委托签约； 第四位取值为1时表示需要强制分期处理； 第五位取值为1时表示不返signPubKeyCert字段 |
应答报文（同步应答）
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 版本号 | version | NS5 | 无 | R-需要返回 | 固定填写5.1.0 |
|
| 编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | 填写报文使用的字符编码 UTF-8|GBK|GB2312|GB18030 若不填写，默认取值：UTF-8 |
|
| 签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 |
|
| 签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3 |
|
| 交易类型 | txnType | N2 | 无 | R-需要返回 | 取值： 00：查询交易 01：消费 02：预授权 03：预授权完成 04：退货 05：圈存 11：代收 12：贷记 13：账单支付 14：转账（保留） 21：批量交易 22：批量查询 31：消费撤销 32：预授权撤销 33：预授权完成撤销 72：实名认证-建立绑定关系 73：账单查询 74：解除绑定关系 75：查询绑定关系 76：文件传输 77：发送短信验证码交易 78：开通查询交易 79：开通交易 94：IC卡脚本通知 95：查询更新加密公钥证书 |
|
| 交易子类 | txnSubType | N2 | 无 | R-需要返回 | 依据实际交易类型填写 00001注 默认取值：00 |
|
| 接入类型 | accessType | N1 | 无 | R-需要返回 | 0：商户直连接入 1：收单机构接入 2：平台商户接入 |
|
| 收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 | 已被批准加入银联互联网系统的收单机构代码 |
|
| 商户代码 | merId | AN15 | 无 | R-需要返回 | 已被批准加入银联互联网系统的商户代码 |
|
| 商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | 商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
| 订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | 商户发送交易时间 |
|
| 请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
| 保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
| 应答码 | respCode | AN2 | 无 | M-必填 | 具体参见应答码定义章节 |
|
| 应答信息 | respMsg | ANS1..256 | 无 | M-必填 | 填写具体的应答信息 |
|
| 签名公钥证书 | signPubKeyCert | AN1..2048 | 无 | C-按条件必填 | 此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。 |
|
| 交易查询流水号 | 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-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 |
|
| 交易币种 | currencyCode | AN3 | 无 | C-按条件必填 | 币种格式必须为3位代码，默认取值：156（人民币） |
|
| 交易金额 | txnAmt | N1..12 | 无 | C-按条件必填 | 单位为分 |
|
| 原交易应答信息 | origRespMsg | ANS1..256 | 无 | C-按条件必填 | ||
| 原交易应答码 | origRespCode | AN2 | 无 | C-按条件必填 | ||
| 账号 | accNo | AN1..1024 | 无 | C-按条件必填 | 交易账号。请求时使用加密公钥对交易账号加密，并做Base64编码后上送；应答时如需返回，则使用签名私钥进行解密。 前台交易可由银联页面采集，也可由商户上送并返显。如需锁定返显卡号，应通过保留域（reserved）上送卡号锁定标识。 |
|
| 支付卡类型 | payCardType | N2 | 无 | C-按条件必填 | 消费交易，视商户配置返回。该域取值为： 00：未知 01：借记账户 02：贷记账户 03：准贷记账户 04：借贷合一账户 05：预付费账户 06：半开放预付费账户 |
|
| 支付方式 | payType | N4 | 无 | C-按条件必填 | 默认不返回此域，如需要返此域，需要提交申请，视商户配置返回，可在消费类交易中返回以下中的一种： 0001：认证支付 0002：快捷支付 0004：储值卡支付 0005：IC卡支付 0201：网银支付 1001：牡丹畅通卡支付 1002：中铁银通卡支付 0401：信用卡支付——暂定 0402：小额临时支付 0403：认证支付2.0 0404：互联网订单手机支付 9000：其他无卡支付(如手机客户端支付) |
|
| 支付卡标识 | payCardNo | ANS1..19 | 无 | C-按条件必填 | 移动支付交易时，根据商户配置返回 |
|
| 支付卡名称 | payCardIssueName | ANS1..64 | 无 | C-按条件必填 | 移动支付交易时，根据商户配置返回 |
|
| 有卡交易信息域 | cardTransData | ANS1Trans | 无 | C-按条件必填 | 查看详情 | |
| 发卡机构识别模式 | issuerIdentifyMode | N1 | 无 | C-按条件必填 | 0：发卡机构自主识别模式 1：发卡机构辅助识别模式 |
|
| 绑定标识号 | bindId | ANS1..128 | 无 | C-按条件必填 | 不支持换行符等不可见字符 用于唯一标识绑定关系 |
|
| 产品类型 | bizType | N6 | 无 | R-需要返回 | 依据实际业务场景填写(目前仅使用后4位，前面2位默认为00) 默认取值：000000 具体取值范围： 000201：B2C网关支付 000301：认证支付2.0 000302：评级支付 000401：贷记 000501：代收 000601：账单支付 000801：跨行收单 000901：绑定支付 001001：订购 00001注 000202：B2B |
|
| 预授权号 | preAuthId | N6 | C-按条件必填 | 预授权交易时返回 |
||
| 分期付款信息域 | instalTransInfo | ANS1..128 | 无 | C-按条件必填 | 查看详情 | |
| 订单优惠信息 | issAddnData | ANS1..8000 | O-选填 | 查看详情 | ||
| 真实卡号摘要 | cardDigest | AN64 | C-按条件必填 | 真实卡号的摘要，为商户提供防黄牛条件 |
中国银联版权所有© 沪ICP备07032180号-2 沪公网安备31011502002335号
