商户可开发“文件传输类交易”接口获取对账文件。
POST
https://filedownload.95516.com/
https://filedownload.test.95516.com/
中文名称 | 英文名称 | 域类型 | 默认值 | 请求要求 | 备注 | |
---|---|---|---|---|---|---|
编码方式 | encoding | ANS1..20 | UTF-8 | M-必填 | 默认取值:UTF-8 | |
签名 | signature | ANS1..1024 | 0 | M-必填 | 填写对报文摘要的签名 | |
产品类型 | bizType | N6 | 无 | M-必填 | 000000 | |
接入类型 | accessType | N1 | 无 | M-必填 |
0:商户直连接入 1:收单机构接入 2:平台商户接入 |
|
商户代码 | merId | AN15 | 无 | M-必填 | ||
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | M-必填 | ||
文件类型 | fileType | N2 | 无 | M-必填 | 据实际业务情况定义 参考7.1:商户索取的文件类型约定 | |
清算日期 | settleDate | MMDD | 无 | M-必填 | ||
签名方法 | signMethod | N2 | 无 | M-必填 | 非对称签名: 01(表示采用RSA签名) HASH表示散列算法 11:支持散列方式验证SHA-256 12:支持散列方式验证SM3 | |
交易类型 | txnType | N2 | 无 | M-必填 | 取值:76 | |
交易子类 | txnSubType | N2 | 无 | M-必填 | 01:对账文件下载 | |
请求方保留域 | 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-需要返回 | ||
订单发送时间 | txnTime | YYYYMMDDhhmmss | 无 | R-需要返回 | ||
文件类型 | fileType | N2 | 无 | R-需要返回 | ||
文件名 | fileName | ANS1..64 | 无 | M-必填 | ||
批量文件内容 | fileContent | ANS1..1000000 | 无 | M-必填 | 文件流方式 | |
清算日期 | settleDate | MMDD | 无 | R-需要返回 | ||
应答码 | respCode | AN2 | 无 | M-必填 | ||
应答信息 | respMsg | ANS1..256 | 无 | M-必填 | ||
签名方法 | signMethod | N2 | 无 | M-必填 | ||
交易类型 | txnType | N2 | 无 | R-需要返回 | 取值:76 | |
交易子类 | txnSubType | N2 | 无 | R-需要返回 | 01:对账文件下载 | |
请求方保留域 | reqReserved | ANS1..1024 | 无 | R-需要返回 | ||
证书ID | certId | N1..128 | 无 | C-按条件必填 | ||
版本号 | version | NS5 | 无 | R-需要返回 |
String merId = req.getParameter("merId");
String settleDate = req.getParameter("settleDate");
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", "76"); //交易类型 76-对账文件下载
data.put("txnSubType", "01"); //交易子类型 01-对账文件下载
data.put("bizType", "000000"); //业务类型,固定
/***商户接入参数***/
data.put("accessType", "0"); //接入类型,商户接入填0,不需修改
data.put("merId", merId); //商户代码,请替换正式商户号测试,如使用的是自助化平台注册的777开头的商户号,该商户号没有权限测文件下载接口的,请使用测试参数里写的文件下载的商户号和日期测。如需777商户号的真实交易的对账文件,请使用自助化平台下载文件。
data.put("settleDate", settleDate); //清算日期,如果使用正式商户号测试则要修改成自己想要获取对账文件的日期, 测试环境如果使用700000000000001商户号则固定填写0119
data.put("txnTime",DemoBase.getCurrentTime()); //订单发送时间,取系统时间,格式为YYYYMMDDhhmmss,必须取当前时间,否则会报txnTime无效
data.put("fileType", "00"); //文件类型,一般商户填写00即可
/**请求参数设置完毕,以下对请求参数进行签名并发送http post请求,接收同步应答报文------------->**/
Map<String, String> reqData = AcpService.sign(data,DemoBase.encoding); //报文中certId,signature的值是在signData方法中获取并自动赋值的,只要证书配置正确即可。
String url = SDKConfig.getConfig().getFileTransUrl(); //获取请求银联的前台地址:对应属性文件acp_sdk.properties文件中的acpsdk.fileTransUrl
Map<String, String> rspData = AcpService.post(reqData, url,DemoBase.encoding);
/**对应答码的处理,请根据您的业务逻辑来编写程序,以下应答码处理逻辑仅供参考------------->**/
//应答码规范参考open.unionpay.com帮助中心 下载 产品接口规范 《平台接入接口规范-第5部分-附录》
String fileContentDispaly = "";
if(!rspData.isEmpty()){
if(AcpService.validate(rspData, DemoBase.encoding)){
LogUtil.writeLog("验证签名成功");
String respCode = rspData.get("respCode");
if("00".equals(respCode)){
//交易成功,解析返回报文中的fileContent并落地
String zipFilePath = AcpService.deCodeFileContent(rspData,"d:\\",DemoBase.encoding);
//对落地的zip文件解压缩并解析
String outPutDirectory ="d:\\";
List<String> fileList = DemoBase.unzip(zipFilePath, outPutDirectory);
//解析ZM,ZME文件
for(String file : fileList){
if(file.indexOf("ZM_")!=-1){
List<Map> ZmDataList = DemoBase.parseZMFile(file);
fileContentDispaly = DemoBase.getFileContentTable(ZmDataList,file);
}else if(file.indexOf("ZME_")!=-1){
DemoBase.parseZMEFile(file);
}
}
//TODO
}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>请求报文:<br/>"+reqMessage+"<br/>" + "应答报文:</br>"+rspMessage+"</br>"+fileContentDispaly);
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):
验证签名失败;
报文格式错(包含,必填域缺失,上送银联报文未定义的域,报文域的格式非法,交易时间超出范围);
签名失败;
超时等其他系统异常