为了给您提供更好的服务，我们诚邀您填写开放平台使用反馈调研
问题反馈
关闭
接口描述
对于未收到交易结果的联机交易，商户应向银联全渠道支付平台发起交易状态查询交易，查询交易结果。完成交易的过程不需要同持卡人交互，属于后台交易。交易查询类交易可由商户通过SDK向银联全渠道支付交易平台发起交易。
请求方式
POST
生产调用地址
https://gateway.95516.com/gateway/api/backTransReq.do
测试调用地址
https://101.231.204.80:5000/gateway/api/backTransReq.do
请求参数 | 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 版本号 | version | NS5 | 无 | M-必填 | 固定填写 | |
| 编码方式 | 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：普通商户直连接入 2：平台类商户接入 |
|
| 签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 | |
| 签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3 | |
| 商户代码 | merId | AN15 | 无 | M-必填 | ||
| 商户订单号 | orderId | AN8..40 | 无 | M-必填 | ||
| 证书ID | certId | N1..128 | 无 | M-必填 | ||
| 保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
| 控制规则 | ctrlRule | N32 | 无 | O-选填 |
32位01字符串控制位， 从左至右第五位取值为1时表示不返signPubKeyCert字段 |
应答报文（同步应答）
| 中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
|---|---|---|---|---|---|---|
| 查询流水号 | 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-必填 | ||
| 兑换日期 | exchangeDate | MMDD | 无 | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |
| 发卡机构识别模式 | issuerIdentifyMode | N1 | 无 | C-按条件必填 | 消费、预授权交易返回 | |
| 交易币种 | currencyCode | AN3 | 无 | C-按条件必填 | ||
| 交易金额 | txnAmt | N1..12 | 无 | C-按条件必填 | ||
| 签名公钥证书 | signPubKeyCert | AN2048 | 无 | C-按条件必填 | 使用RSA签名方式时必选，此域填写银联签名公钥证书。 | |
| 清算汇率 | exchangeRate | N8 | 无 | C-按条件必填 | 交易成功，交易币种和清算币种不一致的时候返回 | |
| 原交易应答码 | origRespCode | AN2 | 无 | C-按条件必填 | 查询交易成功时返回 | |
| 原交易应答信息 | origRespMsg | ANS1..256 | 无 | C-按条件必填 | ||
| 账号 | accNo | AN1..1024 | 无 | C-按条件必填 | 根据商户配置返回 | |
| 支付方式 | payType | N4 | 无 | C-按条件必填 | （消费、预授权）根据商户配置返回 | |
| 支付卡类型 | payCardType | N2 | 无 | C-按条件必填 | （消费、预授权）根据商户配置返回 | |
| 版本号 | version | NS5 | 无 | R-需要返回 | ||
| 编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | ||
| 订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | 被查询交易的交易时间 | |
| 接入类型 | accessType | N1 | 无 | R-需要返回 | ||
| 商户代码 | merId | AN15 | 无 | R-需要返回 | ||
| 商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | 被查询交易的订单号 | |
| 保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
| 订单优惠信息 | issAddnData | ANS1..8000 | O-选填 | 查看详情 | ||
| 请求方保留域 | reqReserved | ANS1..1024 | 无 | O-选填 | 返回被查询交易的请求方保留域 |
异常应答说明
1. 不返回报文体的情况：
版本号，交易类型、子类，签名方法，签名值等关键域未上送，返回“Invalid request.”；
交易类型和请求地址校验有误，返回“Invalid request URI.”
2. 返回全部的请求报文，附加应答码和应答描述（包括的应答码有：01、02、03、10、11、32）：
验证签名失败；
报文格式错（包含，必填域缺失，上送银联报文未定义的域，报文域的格式非法，交易时间超出范围）；
签名失败；
超时等其他系统异常
中国银联版权所有©2002-2023沪 ICP备07032180号
