商户可通过填写账单编号等信息,使用账单查询类交易为持卡人提供如便民缴费、网上缴税、信用卡还款、保险缴费等相关的账单查询服务。账单查询类交易可由商户通过SDK向银联全渠道支付交易平台发起交易。
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-必填 | ||
二级商户代码 | subMerId | AN5..15 | 无 | C-按条件必填 | 商户类型为平台类商户接入时必须上送 | |
二级商户名称 | subMerName | ANS1..40 | 无 | C-按条件必填 | 商户类型为平台类商户接入时必须上送 | |
二级商户简称 | subMerAbbr | ANS1…16 | 无 | C-按条件必填 | 商户类型为平台类商户接入时必须上送 | |
商户订单号 | orderId | AN8..40 | 无 | M-必填 |
商户订单号,不能含“-”或“_”; 商户自定义,同一交易日期内不可重复; 商户代码merId、商户订单号orderId、订单发送时间txnTime三要素唯一确定一笔交易。 |
|
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | M-必填 | ||
业务代码 | bussCode | ANS4..20 | 无 | M-必填 | busscode 三元组:账单类型_地区码_附加地区码 示例:D1_3300_0000 账单类型、地区码、附加地区码参考获取账单业务要素(BIZ)说明 | |
账单要素 | billQueryInfo | ANS1..2048 | 无 | O-选填 | 查看详情 | |
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
渠道类型 | channelType | N2 | 无 | M-必填 | 07:互联网 08:移动 | |
签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 | |
交易类型 | txnType | N2 | 无 | M-必填 | 73 | |
交易子类 | txnSubType | N2 | 无 | M-必填 | 01:便民缴费 | |
请求方保留域 | reqReserved | ANS1..1024 | 无 | O-选填 | 商户自定义保留域,交易应答时会原样返回 | |
证书ID | certId | N1..128 | 无 | C-按条件必填 | ||
版本号 | version | NS5 | 无 | M-必填 | 固定填写5.0.0 | |
原交易查询流水号 | origQryId | AN21 | 无 | C-按条件必填 | 多次查询交易,需上送上一笔查询交易返回的queryId | |
收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 |
接入类型为收单机构接入时出现 |
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
版本号 | version | NS5 | 无 | R-需要返回 | ||
签名 | signature | ANS1..1024 | 0 | M-必填 | ||
编码方式 | encoding | ANS1..20 | UTF-8 | R-需要返回 | ||
签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 |
|
交易类型 | txnType | N2 | 无 | R-需要返回 | ||
交易子类 | txnSubType | N2 | 无 | R-需要返回 | ||
产品类型 | bizType | N6 | 无 | R-需要返回 | ||
接入类型 | accessType | N1 | 无 | R-需要返回 | 0:商户直连接入 1:收单机构接入 2:平台商户接入 |
|
收单机构代码 | acqInsCode | AN8..11 | 无 | C-按条件必填 | 接入类型为收单机构接入时需返回 |
|
商户代码 | merId | AN15 | 无 | R-需要返回 | ||
商户订单号 | orderId | AN8..40 | 无 | R-需要返回 | ||
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | 商户发送交易时间 |
|
账单明细 | billDetailInfo | ANS1..2048 | 无 | O-选填 | 查看详情 | |
请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
保留域 | reserved | ANS1..2048 | 无 | O-选填 | 查看详情 | |
应答码 | respCode | AN2 | 无 | M-必填 | 具体参见应答码定义章节 |
|
应答信息 | respMsg | ANS1..256 | 无 | M-必填 | 填写具体的应答信息 |
|
查询流水号 | queryId | AN20..21 | 无 | M-必填 | 若是先查询后缴费,则在缴费交易需上送此流水号 |
|
签名公钥证书 | signPubKeyCert | AN1..2048 | 无 | C-按条件必填 | 此域填写银联签名公钥证书,使用RSA签名方式时,默认返回,如果ctrlRule第五位为1时,不返。 |
String merId = req.getParameter("merId");
String orderId = req.getParameter("orderId");
String txnTime = req.getParameter("txnTime");
String bussCode = req.getParameter("bussCode");
String billQueryInfo = req.getParameter("billQueryInfo");
String origQryId = req.getParameter("origQryId");
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", "73"); //交易类型 73 账单查询
data.put("txnSubType", "01"); //交易子类型 01 便民缴费
data.put("bizType", "000601"); //业务类型
data.put("channelType", "07"); //渠道类型
data.put("accessType", "0");
/***商户接入参数***/
data.put("merId", merId); //商户号码(商户号码777290058110097仅做为测试调通交易使用,该商户号配置了需要对敏感信息加密)测试时请改成自己申请的商户号,【自己注册的测试777开头的商户号不支持代收产品】
data.put("orderId", orderId); //商户订单号,8-40位数字字母,不能含“-”或“_”,可以自行定制规则
data.put("txnTime", txnTime); //订单发送时间,格式为YYYYMMDDhhmmss,必须取当前时间,否则会报txnTime无效
data.put("bussCode", bussCode);// 业务类型号,此处默认取demo演示页面传递的参数
data.put("billQueryInfo", AcpService.base64Encode(billQueryInfo,DemoBase.encoding));// 账单要素,根据前文显示要素列表由用户填写值,此处默认取demo演示页面传递的参数
if(null!=origQryId && !"".equals(origQryId)){
data.put("origQryId", origQryId);
}
/**对请求参数进行签名并发送http post请求,接收同步应答报文**/
Map<String, String> reqData = AcpService.sign(data,DemoBase.encoding);//报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。
String requestBackUrl = SDKConfig.getConfig().getJfBackRequestUrl(); //交易请求url从配置文件读取对应属性文件acp_sdk.properties中的 acpsdk.backTransUrl
Map<String, String> rspData = AcpService.post(reqData,requestBackUrl,DemoBase.encoding); //发送请求报文并接受同步应答(默认连接超时时间30秒,读取返回结果超时时间30秒);这里调用signData之后,调用submitUrl之前不能对submitFromData中的键值对做任何修改,如果修改会导致验签不通过
/**对应答码的处理,请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**/
//应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》
if(!rspData.isEmpty()){
if(AcpService.validate(rspData, DemoBase.encoding)){
LogUtil.writeLog("验证签名成功");
String respCode = rspData.get("respCode") ;
if(("00").equals(respCode)){
//成功
//TODO
String queryId = rspData.get("queryId");
String billDetailInfo = AcpService.base64Decode(rspData.get("billDetailInfo"),DemoBase.encoding);
//*****以下注释的账单查询结果可以自行调试使用********//
//账单查询查询到的 bill类型账单支付展示页面(账单条目项)
//String billDetailInfo="{\"title\":\"账单缴费 - 青岛联通GSM\",\"form\":[{\"type\":\"string\",\"label\":\"合同号\",\"value\":\"3200401849\"},{\"type\":\"string\",\"label\":\"用户名\",\"value\":\"马振海\"},{\"type\":\"string\",\"label\":\"代表号\",\"value\":\"13061339218\"},{\"type\":\"string\",\"label\":\"手机区域\",\"value\":\"0532\"},{\"type\":\"string\",\"label\":\"用户数量\",\"value\":\"1\"},{\"value\":\"后付费\",\"label\":\"付费标志\",\"type\":\"String\"},{\"type\":\"hidden\",\"name\":\"amount\",\"value\":\"45.71\"},{\"type\":\"string\",\"label\":\"账单金额(元)\",\"value\":\"45.71\",\"name\":\"amountstr\"},{\"name\":\"owe_tag\",\"value\":\"D\",\"label\":\"欠费标志\",\"type\":\"hidden\"}],\"action\":\"prepay\",\"code\":\"I1_4520_0001\"}";
//账单查询查询到的 singlebill类型账单支付展示页面(包含详情的单选账单)
//String billDetailInfo="{\"title\": \"账单缴费 - 青岛联通GSM\",\"form\": [{\"type\":\"singlebill\",\"label\":\"账单条目\",\"name\":\"bill_id\",\"options\":[{\"disable\":\"0\",\"label\":\"物业费6.00元\",\"value\":\"1234567890\",\"amount\":\"6.00\",\"detail\":[{\"label\":\"订单编号\",\"value\":\"00001\"},{\"value\":\"物业费\"},{\"label\":\"账期\",\"value\":\"3月\"},{\"label\":\"收费金额\",\"value\":\"6.00元\"}]},{\"label\":\"取暖费600元\",\"disable\":\"1\",\"value\":\"1234567891\",\"amount\":\"600\",\"detail\":[{\"label\": \"订单编号\",\"value\":\"00002\"},{\"label\":\"收费名称\",\"value\":\"取暖费\"},{\"label\":\"账期\",\"value\":\"3月\"},{\"label\":\"收费金额\",\"value\":\"600元\"}]},{\"label\":\"垃圾费21元\",\"disable\":\"1\",\"value\":\"1234567892\",\"amount\":\"21.00\",\"detail\":[{\"label\":\"订单编号\",\"value\":\"00003\"},{\"label\":\"收费名称\",\"value\":\"垃圾费\"},{\"label\":\"账期\",\"value\":\"3月\"},{\"label\":\"收费金额\",\"value\":\"21.00元\"}]}]}],\"action\": \"prepay\",\"code\": \"I1_4520_0001\"}";
//账单查询查询到的 multibill类型账单支付展示页面(包含详情的可多选账单)
//String billDetailInfo="{\"title\": \"账单缴费 - 青岛联通GSM\",\"form\": [{\"type\": \"multibill\",\"label\": \"账单条目\",\"name\": \"mbill_no\",\"options\": [{\"label\": \"物业费6.00元\",\"value\": \"1\",\"amount\": \"6.00\",\"detail\": [{\"label\": \"订单编号\",\"value\": \"00001\"},{\"label\": \"收费名称\",\"value\": \"物业费\"},{\"label\": \"账期\",\"value\": \"3月\"},{\"label\": \"收费金额\",\"value\": \"6.00元\"}]},{\"label\": \"取暖费600元\",\"value\": \"2\",\"amount\": \"600\",\"detail\": [{\"label\": \"订单编号\",\"value\": \"00002\"},{\"label\": \"收费名称\",\"value\": \"取暖费\"},{\"label\": \"账期\",\"value\": \"3月\"},{\"label\": \"收费金额\",\"value\": \"600元\"}]},{\"label\": \"垃圾费21元\",\"value\": \"3\",\"amount\": \"21.00\",\"detail\": [{\"label\": \"订单编号\",\"value\": \"00003\"},{\"label\": \"收费名称\",\"value\": \"垃圾费\"},{\"label\": \"账期\",\"value\": \"3月\"},{\"label\": \"收费金额\",\"value\": \"21.00元\"}]}]}],\"action\": \"prepay\",\"code\": \"I1_4520_0001\"}";
//账单查询查询到的 multibillstring类型账单支付展示页面(包含详情的多账单明细展示项)
//String billDetailInfo ="{\"title\": \"账单缴费 - 青岛联通GSM\",\"form\": [{\"type\": \"multibillstring\",\"label\": \"账单条目\",\"options\": [{\"label\": \"物业费6.00元\",\"amount\": \"6.00\",\"detail\": [{\"label\": \"订单编号\",\"value\": \"00001\"},{\"label\": \"收费名称\",\"value\": \"物业费\"},{\"label\": \"账期\",\"value\": \"3月\"},{\"label\": \"收费金额\",\"value\": \"6.00元\"}]},{\"label\": \"取暖费600元\",\"amount\": \"600\",\"detail\": [{\"label\": \"订单编号\",\"value\": \"00002\"},{\"label\": \"收费名称\",\"value\": \"取暖费\"},{\"label\": \"账期\",\"value\": \"3月\"},{\"label\": \"收费金额\",\"value\": \"600元\"}]},{\"label\": \"垃圾费21元\",\"amount\": \"21.00\",\"detail\": [{\"label\": \"订单编号\",\"value\": \"00003\"},{\"label\": \"收费名称\",\"value\": \"垃圾费\"},{\"label\": \"账期\",\"value\": \"3月\"},{\"label\": \"收费金额\",\"value\": \"21.00元\"}]}]}],\"action\": \"prepay\",\"code\": \"I1_4520_0001\"}";
// 带button的
//String billDetailInfo ="{\"code\":\"I1_8700_0821\",\"action\":\"none\",\"title\":\"账单缴费 - 宁夏有线电视\",\"form\":[{\"value\":\"张三\",\"label\":\"客户姓名\",\"type\":\"string\"},{\"value\":\"XX路XX号\",\"label\":\"用户地址\",\"type\":\"string\"},{\"value\":\"正常\",\"label\":\"用户状态\",\"type\":\"string\"},{\"value\":\"0.00\",\"label\":\"本期余额(元)\",\"type\":\"string\"},{\"name\":\"businessType\",\"value\":\"2\",\"action\":\"prequery\",\"label\":\"确认\",\"type\":\"button\"},{\"name\":\"businessType\",\"value\":\"3\",\"action\":\"prepay\",\"label\":\"随便点点\",\"type\":\"button\"}]}";
String respJson = "{\"queryId\":\""+queryId+"\",\"billDetailInfo\":"+billDetailInfo+"}";
System.out.println("respJson:"+respJson);
resp.getWriter().write(respJson);
return;
}else{
//其他应答码为失败请排查原因或做失败处理
//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/>"+reqMessage+"<br/>" + "应答报文:</br>"+rspMessage+"");
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");
1. 不返回报文体的情况:
版本号,交易类型、子类,签名方法,签名值等关键域未上送,返回“Invalid request.”;
交易类型和请求地址校验有误,返回“Invalid request URI.”
2. 返回全部的请求报文,附加应答码和应答描述(包括的应答码有:01、02、03、10、11、32):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常