中国银联开放平台

接口描述

代缴建立委托交易状态查询，对于未收到交易结果的代缴建立委托联机交易，商户应向银联全渠道平台发起代缴建立委托交易状态查询交易，查询是否成功建立代缴委托。完成交易的过程不需要同持卡人交互，属于后台交易。

请求方式

POST

生产调用地址

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

测试调用地址

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

请求参数

中文名称	英文名称	域类型	默认值	请求要求	备注
编码方式	encoding	ANS1..20	UTF-8	M-必填	默认取值：UTF-8
签名	signature	ANS1..1024	0	M-必填	填写对报文摘要的签名
产品类型	bizType	N6	无	M-必填	000601：账单支付
接入类型	accessType	N1	无	M-必填	0：商户直连接入 1：收单机构接入 2：平台商户接入
商户代码	merId	AN15	无	M-必填
商户订单号	orderId	AN8..40	无	M-必填	商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。
订单发送时间	txnTime	YYYYMMDDhhmmss	无	M-必填	商户发送交易时间
账号类型(卡介质)	accType	N2	无	O-选填
账号	accNo	AN1..1024	无	C-按条件必填	交易子类00- 账号查询填写（接入类型为收单机构接入时不支持卡尾号查询）
银行卡验证信息及身份信息	customerInfo	ANS1..1024	无	C-按条件必填	查看详情
保留域	reserved	ANS1..2048	无	O-选填	查看详情
加密证书ID	encryptCertId	N1..128	无	C-按条件必填
渠道类型	channelType	N2	无	M-必填
签名方法	signMethod	N2	无	M-必填	非对称签名： 01（表示采用RSA签名） HASH表示散列算法 11：支持散列方式验证SHA-256 12：支持散列方式验证SM3
交易类型	txnType	N2	无	M-必填	取值：75
交易子类	txnSubType	N2	无	M-必填	02：代缴建立委托查询
请求方保留域	reqReserved	ANS1..1024	无	O-选填	商户自定义保留域，交易应答时会原样返回
证书ID	certId	N1..128	无	C-按条件必填
版本号	version	NS5	无	M-必填	固定填写

应答报文（同步应答）

中文名称	英文名称	域类型	默认值	请求要求	备注
编码方式	encoding	ANS1..20	UTF-8	R-需要返回
签名	signature	ANS1..1024	0	M-必填
产品类型	bizType	N6	无	R-需要返回
接入类型	accessType	N1	无	R-需要返回	0：商户直连接入 1：收单机构接入 2：平台商户接入
商户代码	merId	AN15	无	R-需要返回
商户订单号	orderId	AN8..40	无	R-需要返回	商户订单号，不能含“-”或“_”; 商户自定义，同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。
订单发送时间	txnTime	YYYYMMDDhhmmss	无	R-需要返回
账号	accNo	AN1..1024	无	C-按条件必填	根据商户配置返回
支付卡类型	payCardType	N2	无	C-按条件必填	根据商户配置是否返回
发卡机构代码	issInsCode	AN1..11	无	C-按条件必填	返回银行简码。银行简码列表参考附录：C.3
银行卡验证信息及身份信息	customerInfo	ANS1..1024	无	C-按条件必填	查看详情
保留域	reserved	ANS1..2048	无	O-选填	查看详情
应答码	respCode	AN2	无	M-必填
应答信息	respMsg	ANS1..256	无	M-必填
开通状态	activateStatus	N1	无	M-必填	0：未开通业务 1：已开通银联全渠道支付
签名方法	signMethod	N2	无	M-必填
签名公钥证书	signPubKeyCert	AN1..2048	无	C-按条件必填	此域填写银联签名公钥证书，使用RSA签名方式时，默认返回，如果ctrlRule第五位为1时，不返。
交易类型	txnType	N2	无	R-需要返回	取值：75
交易子类	txnSubType	N2	无	R-需要返回	默认：02
请求方保留域	reqReserved	ANS1..1024	无	R-需要返回
版本号	version	NS5	无	R-需要返回

示例代码

Java

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", "74"); //交易类型 00-默认

data.put("txnSubType", "03"); //交易子类型默认00

data.put("bizType", ""); //业务类型代收

/***商户接入参数***/

data.put("merId", merId); //商户号码，请改成自己申请的商户号或者open上注册得来的777商户号测试

data.put("accessType", "0"); //接入类型，商户接入固定填0，不需修改

/***要调通交易以下字段必须修改***/

data.put("orderId", orderId); //****商户订单号，每次发交易测试需修改为被查询的交易的订单号

data.put("txnTime", txnTime); //****订单发送时间，每次发交易测试需修改为被查询的交易的订单发送时间

data.put("billQueryInfo",""); //账单要素需做base64 处理

data.put("bussCode",""); //业务戴安账单类型_地区码_附加地区码

/**请求参数设置完毕，以下对请求参数进行签名并发送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+"");

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", "75"); //交易类型 00-默认

data.put("txnSubType", "02"); //交易子类型默认00

data.put("bizType", "000601"); //业务类型代收

/***商户接入参数***/

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");

暂无代码

Java

Java

LogUtil.writeLog("BackRcvResponse接收后台通知开始");

String encoding = req.getParameter(SDKConstants.param_encoding);

// 获取银联通知服务器发送的后台通知参数

Map<String, String> reqParam = getAllRequestParam(req);

LogUtil.printRequestLog(reqParam);

Map<String, String> valideData = null;

if (null != reqParam && !reqParam.isEmpty()) {

Iterator<Entry<String, String>> it = reqParam.entrySet().iterator();

valideData = new HashMap<String, String>(reqParam.size());

while (it.hasNext()) {

Entry<String, String> e = it.next();

String key = (String) e.getKey();

String value = (String) e.getValue();

valideData.put(key, value);

}

//重要！验证签名前不要修改reqParam中的键值对的内容，否则会验签不过

if (!AcpService.validate(valideData, encoding)) {

LogUtil.writeLog("验证签名结果[失败].");

//验签失败，需解决验签问题

} else {

LogUtil.writeLog("验证签名结果[成功].");

//【注：为了安全验签成功才应该写商户的成功处理逻辑】交易成功，更新商户订单状态

String orderId =valideData.get("orderId"); //获取后台通知的数据，其他字段也可用类似方式获取

String respCode = valideData.get("respCode");

}

LogUtil.writeLog("BackRcvResponse接收后台通知结束");

//返回给银联服务器http 200 状态码

resp.getWriter().print("ok");

暂无代码

Java

异常应答说明

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

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

提示信息

提示