商户对账文件下载通联支付网络服务股份有限公司商户对账文件下载通联支付网络服务股份有限公司通联支付网络服务股份有限公司

Size: px

Start display at page:

Download "商户对账文件下载通联支付网络服务股份有限公司商户对账文件下载通联支付网络服务股份有限公司通联支付网络服务股份有限公司"

别斑项
5 years ago
Views:

1 商户对账文件下载

2 版本控制信息文档名称 : 通联互联网支付网关商户对账文件下载技术规范当前版本号 : 2.2 文档编号 : 撰写者 : 日期 : 复核者 : 日期 : 审批者 : 日期 : 版本历史 : 版本日期拟稿和修改说明苗洪梅初稿徐仁彬修改孙淑静修改孙淑静修改 ( 基于二代系统 ) 孙淑静修改 settledate 参数孙淑静增加模板 2 内容描述版权声明 : 此文档的版权归所有, 未经的书面许可, 不得向第三方借阅出让出版该文档 2 2

1. 目的文档为使用通联互联网支付网关的商户开发者编写本文档为通联互联网支付网关的开发者和相关人员提供有效的指引和帮助本文档的目标读者为技术人员 2. 对账文件下载商户对账文件下载目前有两种方式 : 登录通联商户服务平台 (http(s):// 通联支付网关地址 /ms/onlinebill/download) 下载对账文件 HTTP 方式下载对账文件 3.

3 1. 目的文档为使用通联互联网支付网关的商户开发者编写本文档为通联互联网支付网关的开发者和相关人员提供有效的指引和帮助本文档的目标读者为技术人员 2. 对账文件下载商户对账文件下载目前有两种方式 : 登录通联商户服务平台 (http(s):// 通联支付网关地址 /ms/onlinebill/download) 下载对账文件 HTTP 方式下载对账文件 3. 对账文件格式对账文件目前有模板一和模板二, 系统默认配置是模板一, 如有需要模板二可申请配置 3.1 模板一第一行为汇总信息 : 结算日期批次号交易笔数成功笔数交易金额退款笔数退款金额手续费清算金额第二行开始为交易明细 : 交易类型结算日期商户号交易时间商户订单号通联流水号交易金额手续费清算金额币种商户原始订单金额 ( 分 ) 备注 : 币种采用国标形式 (3 位数字, 比如人民币 156 美元 840 等 ) 文件最后为签名信息, 与交易明细间有一空行请参考对账文件范例如下 : 汇总和交易明细明文 : 3 3

4 签名信息 : 3.2 模板二第一行为汇总信息 : 结算日期批次号交易笔数成功笔数交易金额退款笔数退款金额商户手续费清算金额第二行开始为交易明细 : 商户号商户名称商户订单号通联流水号银行订单号交易机构订单时间支付状态交易币种交易汇率扣款金额 ( 元 ) 手续费 ( 元 ) 清算金额 ( 元 ) 付款人卡号补单状态撤销标记支付完成时间备注 : 币种采用国标形式 (3 位数字, 比如人民币 156 美元 840 等 ) 文件最后为签名信息, 与交易明细间有一空行支付类型说明 : ZF: 支付成功 TH: 退款, 通联系统扎差成功, 退款请求发送到银行 CX: 冲销成功, 未能成功退款, 资金已经退回给商户 4. HTTP 方式下载对账文件接口 4.1 下载请求参数说明注意 : 测试环境提交地址支持 http, 不支持 https; 生产环境请使用 https 提交提交地址生产 : 商户接入环境 : 参数名称参数含义长度可否为空参数说明报文参数 mchtcd 商户号 15 不可空由通联统一分配 4 4

5 settledate 清算日期 10 不可空格式为 yyyy-mm-dd, 是指通联清算的自然日期 ( 通联 T 日清算 ) signmsg 签名字符串不可空摘源串为商户号结算日期及 md5key 字符串连接而成, 再通过 MD5 摘要产生例如 : 用于 MD5 摘要的字符串 : pwd123 生成的 MD5 摘要即 signmsg 为 : 667C0C D1A0DF25B 错误代码描述 * ERRORCODE:001 ERRORDES: 系统繁忙. 请稍候... * ERRORCODE:002 ERRORDES: 请传入有效的商户号, 结算日期,signMsg * ERRORCODE:003 ERRORDES: 结算日期格式错误 ( 格式为 yyyy-mm-dd) * ERRORCODE:004 ERRORDES: 商户号不存在或者 MD5key 没有设置 * ERRORCODE:005 ERRORDES: 摘要信息验证有误 * ERRORCODE:006 ERRORDES: 没有相应的对账信息 4.3 对账文件验证签名为保障文件来源的安全性, 商户需要对下载的文件先进行验证签名, 再解析对账文件 ; 开发包安装方法及验签方法请参考通联互联网支付网关商户接口技术规范 ; 明文和密文在文件中以空行分开, 空行及前面的行为明文, 空行后的一行为密文 ; ( 请参考的对账文件图示 ) 其中明文需要先进行 MD5 摘要, 再调用验证签名方法 4.4 JAVA 示例代码 5 5 import java.io.bufferedreader; import java.io.ioexception; import java.io.inputstreamreader; import java.net.httpurlconnection; import java.net.url;

6 import java.security.keymanagementexception; import java.security.nosuchalgorithmexception; import java.security.securerandom; import java.security.cert.certificateexception; import java.security.cert.x509certificate; import javax.net.ssl.hostnameverifier; import javax.net.ssl.httpsurlconnection; import javax.net.ssl.sslcontext; import javax.net.ssl.sslsession; import javax.net.ssl.sslsocketfactory; import javax.net.ssl.trustmanager; import javax.net.ssl.x509trustmanager; import org.apache.commons.httpclient.httpexception; import org.bouncycastle.util.encoders.base64; import com.allinpay.ets.client.securityutil; public class CheckfileDownloadTest { public static void main(string[] args) { String serverurl = " http(s):// 通联支付网关地址 /member/checkfiledown/checkfiledownload/checkfiledownload.do"; String mchtcd = " "; // 商户号 String settledate = " "; // 格式为 yyyy-mm-dd String md5key = " "; // md5key String fileasstring = ""; // 签名信息前的对账文件内容 String filesignmsg = ""; // 文件签名信息 boolean isverified = false; // 验证签名结果 try { // 得到摘要 (MD5Encode 函数的传入参数为商户号 + 结算日期 +md5key) String signmsg = SecurityUtil.MD5Encode(mchtCd + settledate + md5key); // 建立连接 URL url = new URL(serverUrl + "?mchtcd=" + mchtcd + "&settledate=" + settledate + "&signmsg=" + signmsg); CheckfileDownloadTest test = new CheckfileDownloadTest(); HttpURLConnection httpconn = test.gethttpsurlconnection(url); httpconn.connect(); 6 6 // 读取交易结果 BufferedReader filereader = new BufferedReader( new InputStreamReader(httpConn.getInputStream())); StringBuffer filebuf = new StringBuffer(); // 签名信息前的字符串

7 String lines; while ((lines = filereader.readline())!= null) { if (lines.length() > 0) { // 按行读, 每行都有换行符 filebuf.append(lines + "\r\n"); else { // 文件中读到空行, 则读取下一行为签名信息 filesignmsg = filereader.readline(); filereader.close(); fileasstring = filebuf.tostring(); System.out.println("File: \n" + fileasstring); System.out.println("Sign: \n" + filesignmsg); 验证签名 // 验证签名 : 先对文件内容计算 MD5 摘要, 再将 MD5 摘要作为明文进行 String filemd5 = SecurityUtil.MD5Encode(fileAsString); isverified = SecurityUtil.verifyByRSA("c:/TLCert.cer", filemd5.getbytes(), Base64.decode(fileSignMsg)); 账..."); if (isverified) { // 验证签名通过, 解析交易明细, 开始对账 System.out.println(" 验证签名通过, 解析交易明细, 开始对 else { // 验证签名不通过, 丢弃对账文件 System.out.println(" 验证签名不通过, 丢弃对账文件 "); 7 7 catch (HttpException e) { catch (IOException e) { catch (SecurityException e) { catch (Exception e) {

8 /* * 得到 HttpURLConnection : : public HttpURLConnection gethttpsurlconnection(url url) { try { HttpURLConnection httpconnection = (HttpURLConnection) url.openconnection(); httpconnection; 书过滤主机名过滤 if ("https".equals(url.getprotocol())) // 如果是 https 协议 { HttpsURLConnection httpsconn = (HttpsURLConnection) TrustManager[] managers = { new MyX509TrustManager() ;// 证 SSLContext sslcontext; sslcontext = SSLContext.getInstance("TLS"); sslcontext.init(null, managers, new SecureRandom()); SSLSocketFactory ssf = sslcontext.getsocketfactory(); httpsconn.setsslsocketfactory(ssf); httpsconn.sethostnameverifier(new MyHostnameVerifier());// return httpsconn; return httpconnection; catch (NoSuchAlgorithmException e) { catch (KeyManagementException e) { catch (IOException e1) { e1.printstacktrace(); return null; 8 8 /* * :

9 public class MyX509TrustManager implements X509TrustManager { authtype) /** * 该方法体为空时信任所有客户端证书 * chain authtype CertificateException public void checkclienttrusted(x509certificate[] chain, String throws CertificateException { /** * 该方法体为空时信任所有服务器证书 * chain authtype CertificateException authtype) public void checkservertrusted(x509certificate[] chain, String throws CertificateException { /** * 返回信任的证书 * public X509Certificate[] getacceptedissuers() { return null; 9 9 /* * : private class MyHostnameVerifier implements HostnameVerifier {

10 /** * 返回 true 时为通过认证当方法体为空时, 信任所有的主机名 * hostname session public boolean verify(string hostname, SSLSession session) { return true; 执行输出 : File: ZF :18:27 NO Sign: T4eB4OMvGUX2oYphcgLAAi7JGNPhipB9AcHcPFaQbx1J3AVYp18ppzH1roW/bMUlMm5ee k9vml4zlvvj+5fcy1bm2tszjmxbzrl09slpygnipdrjdajqkxe7otcr/woj6fwqs1/ku9 wway4nhjbueu+glmh2mc7l1fmw8sirdda= 验证签名通过, 解析交易明细, 开始对账

通联支付网络服务股份有限公司

通联支付网络服务股份有限公司海关商户扩展字段补充说明版本 v1.0 通联支付网络服务股份有限公司 2015 年 4 月 8 日文件修改记录修改说明版本变更审核批准时间变更人时间审核人时间批准人新建 1.0 2015.04.08 郝捍东新增郑州海关 1.1 2015.04.29 郝捍东目录 1. 目的... 4 2. 说明... 4 3. 商户系统接入扩展字段定义... 4 3.1

商户对账文件下载通联支付网络服务股份有限公司 商户对账文件下载 通联支付网络服务股份有限公司 通联支付网络服务股份有限公司

商户对账文件下载通联支付网络服务股份有限公司商户对账文件下载通联支付网络服务股份有限公司通联支付网络服务股份有限公司