对于未收到交易结果的联机交易,商户应向银联全渠道支付平台发起交易状态查询交易,查询交易结果。交易查询类交易可由商户通过SDK向银联全渠道支付交易平台发起交易。
POST
https://gateway.95516.com/gateway/api/queryTrans.do
https://gateway.test.95516.com/gateway/api/queryTrans.do
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
版本号 | version | NS5 | 无 | M-必填 | 固定填写 | |
编码方式 | encoding | ANS1..20 | UTF-8 | M-必填 | 默认取值:UTF-8 | |
证书ID | certId | N1..128 | 无 | M-必填 | ||
签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 | |
签名方法 | signMethod | N2 | 无 | M-必填 | 取值: 非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 | |
交易类型 | txnType | N2 | 无 | M-必填 | 交易类型 00 | |
交易子类 | txnSubType | N2 | 无 | M-必填 | 默认:00 流水号查询:02 | |
产品类型 | bizType | N6 | 无 | M-必填 | 默认:000000 | |
接入类型 | accessType | N1 | 无 | M-必填 |
0:商户直连接入 1:收单机构接入 2:平台商户接入 |
|
收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 |
已被批准加入银联互联网系统的收单机构代码 |
|
商户代码 | merId | AN15 | 无 | M-必填 | ||
商户名称 | merName | ANS1..40 | 无 | C-按条件必填 |
接入类型为收单机构接入时需上送 不支持换行符等不可见字符 |
|
商户英文名称 | merEnName | ANS40 | C-按条件必填 | 查看详情 | ||
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | C-按条件必填 | 同被查询交易 orderId + txnTime 、queryId二者必送其一 | |
商户订单号 | orderId | AN8..40 | 无 | C-按条件必填 |
商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
控制规则 | ctrlRule | N32 | 无 | O-选填 |
32位01字符串控制位, 从左至右第一位取值为1表示财税库银信息控制位; 第二位取值为1时表示小微商户; 第三位取值为1时表示河北电力代缴建立委托签约; 第四位取值为1时表示需要强制分期处理; 第五位取值为1时表示不返signPubKeyCert字段 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
版本号 | version | NS5 | 无 | R-需要返回 | ||
编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | ||
签名 | signature | ANS1..1024 | 0 | M-必填 | ||
签名方法 | signMethod | N2 | 无 | M-必填 | ||
交易类型 | txnType | N2 | 无 | M-必填 | 同被查询交易 | |
交易子类 | txnSubType | N2 | 无 | M-必填 | 同被查询交易 | |
接入类型 | accessType | N1 | 无 | R-需要返回 | 0:商户直连接入 1:收单机构接入 2:平台商户接入 |
|
收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 | 已被批准加入银联互联网系统的收单机构代码 |
|
商户代码 | merId | AN15 | 无 | R-需要返回 | ||
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | C-按条件必填 | 被查询交易的交易时间 | |
商户订单号 | orderId | AN8..40 | 无 | C-按条件必填 | 商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
请求方保留域 | reqReserved | ANS1..1024 | 无 | O-选填 | 返回被查询交易的请求方保留域 | |
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
查询流水号 | queryId | AN20..21 | 无 | C-按条件必填 | 被查询交易查询流水号 | |
系统跟踪号 | 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-按条件必填 | ||
交易金额 | txnAmt | N1..12 | 无 | C-按条件必填 | ||
原交易应答码 | origRespCode | AN2 | 无 | C-按条件必填 | 查询交易成功时返回 | |
原交易应答信息 | origRespMsg | ANS1..256 | 无 | C-按条件必填 | ||
应答码 | respCode | AN2 | 无 | M-必填 | ||
应答信息 | respMsg | ANS1..256 | 无 | M-必填 | ||
账号 | accNo | AN1..1024 | 无 | C-按条件必填 | 根据商户配置返回 | |
支付卡类型 | payCardType | N2 | 无 | C-按条件必填 | 根据商户配置返回 | |
支付方式 | payType | N4 | 无 | C-按条件必填 | 根据商户配置返回 | |
支付卡标识 | payCardNo | ANS1..19 | 无 | C-按条件必填 | 移动支付交易时,根据商户配置返回 |
|
支付卡名称 | payCardIssueName | ANS1..64 | 无 | C-按条件必填 | 移动支付交易时,根据商户配置返回 |
|
有卡交易信息域 | cardTransData | ANS1Trans | 无 | C-按条件必填 | 查看详情 | |
发卡机构识别模式 | issuerIdentifyMode | N1 | 无 | C-按条件必填 | 0:发卡机构自主识别模式 1:发卡机构辅助识别模式 |
|
签名公钥证书 | signPubKeyCert | AN1..2048 | 无 | C-按条件必填 | 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。 |
|
产品类型 | bizType | N6 | 无 | R-需要返回 | 依据实际业务场景填写(目前仅使用后4位,前面2位默认为00) 默认取值:000000 具体取值范围: 000201:B2C网关支付 000301:认证支付2.0 000302:评级支付 000401:贷记 000501:代收 000601:账单支付 000801:跨行收单 000901:绑定支付 001001:订购 00001注 000202:B2B |
String merId = req.getParameter("merId");
String orderId = req.getParameter("orderId");
String txnTime = req.getParameter("txnTime");
Map<String, String> data = new HashMap<String, String>();
/***银联全渠道系统,产品参数,除了encoding自行选择外其他不需修改***/
data.put("version", DemoBase.version); //版本号
data.put("encoding", DemoBase.encoding); //字符集编码 可以使用UTF-8,GBK两种方式
data.put("signMethod", SDKConfig.getConfig().getSignMethod()); //签名方法
data.put("txnType", "00"); //交易类型 00-默认
data.put("txnSubType", "00"); //交易子类型 默认00
data.put("bizType", "000201"); //业务类型
/***商户接入参数***/
data.put("merId", merId); //商户号码,请改成自己申请的商户号或者open上注册得来的777商户号测试
data.put("accessType", "0"); //接入类型,商户接入固定填0,不需修改
/***要调通交易以下字段必须修改***/
data.put("orderId", orderId); //****商户订单号,每次发交易测试需修改为被查询的交易的订单号
data.put("txnTime", txnTime); //****订单发送时间,每次发交易测试需修改为被查询的交易的订单发送时间
/**请求参数设置完毕,以下对请求参数进行签名并发送http post请求,接收同步应答报文------------->**/
Map<String, String> reqData = AcpService.sign(data,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。
String url = SDKConfig.getConfig().getSingleQueryUrl(); //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.singleQueryUrl
Map<String, String> rspData = AcpService.post(reqData, url,DemoBase.encoding); //发送请求报文并接受同步应答(默认连接超时时间30秒,读取返回结果超时时间30秒);这里调用signData之后,调用submitUrl之前不能对submitFromData中的键值对做任何修改,如果修改会导致验签不通过
/**对应答码的处理,请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**/
//应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》
if(!rspData.isEmpty()){
if(AcpService.validate(rspData, DemoBase.encoding)){
LogUtil.writeLog("验证签名成功");
if(("00").equals(rspData.get("respCode"))){//如果查询交易成功
String origRespCode = rspData.get("origRespCode");
if(("00").equals(origRespCode)){
//交易成功,更新商户订单状态
//TODO
}else if(("03").equals(origRespCode)||
("04").equals(origRespCode)||
("05").equals(origRespCode)){
//订单处理中或交易状态未明,需稍后发起交易状态查询交易 【如果最终尚未确定交易是否成功请以对账文件为准】
//TODO
}else{
//其他应答码为交易失败
//TODO
}
}else if(("34").equals(rspData.get("respCode"))){
//订单不存在,可认为交易状态未明,需要稍后发起交易状态查询,或依据对账结果为准
}else{//查询交易本身失败,如应答码10/11检查查询报文是否正确
//TODO
}
}else{
LogUtil.writeErrorLog("验证签名失败");
//TODO 检查验证签名失败的原因
}
}else{
//未返回正确的http状态
LogUtil.writeErrorLog("未获取到返回报文或返回http状态码非200");
}
String reqMessage = DemoBase.genHtmlResult(reqData);
String rspMessage = DemoBase.genHtmlResult(rspData);
resp.getWriter().write("交易状态查询交易</br>请求报文:<br/>"+reqMessage+"<br/>" + "应答报文:</br>"+rspMessage+"");
1. 不返回报文体的情况:
版本号,交易类型、子类,签名方法,签名值等关键域未上送,返回“Invalid request.”;
交易类型和请求地址校验有误,返回“Invalid request URI.”
2. 返回全部的请求报文,附加应答码和应答描述(包括的应答码有:01、02、03、10、11、32):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常