中国工商银行银企互联系统接口说明V

中国工商银行银企互联企业服务器安装手册中国工商银行银企互联企业服务器安装手册中国工商银行北京软件研发部2005年02月目录1前言 (3)1.1 使用对象 (3)1.2 如何使用本手册 (3)2网络配置建议 (3)3软件安装与配置 (5)3.1 安装NetSafe Client (5)3.2 运行NetSafe Client (5)3.3 证书的请求和导入 (7)3.3.1 软方式的申请 (8)3.3.2 软方式证书的格式转换 (11)3.3.3 软方式证书导入 (17)3.3.4 工行根证书的注册 (19)3.3.5 硬方式 (19)3.4 加密服务 (23)3.4.1 配置 (23)3.4.2 日志管理 (30)3.5 签名服务 (31)3.5.1 配置 (31)3.5.2 日志管理 (36)4系统的运行 (37)4.1 服务的启动与停止 (37)4.1.1 启动 (37)4.1.2 停止 (37)4.1.3 重启 (37)4.2 NetSafe Client 的配置文件 (38)4.2.1 配置 (38)1前言中国工商银行银企互联企业服务器是架设在企业端的一台Windows 2000平台的服务器，它将银行服务直接延伸到企业，为企业提供更优质的服务。

该服务器上安装有工商银行为银企互联应用专门委托开发的软件NetSafe Client 1.5 for NT，简称NC。

通过这个服务器，企业可以方便地同工商银行网上银行对接，实现财务业务与银行业务的无缝继承。

该手册将给出基于NetSafe Client的银企互联系统网络配置建议，并说明NetSafe Client的安装以及相关的操作指南。

此版本支持磁盘证书和符合PKCS11标准的硬件设备（如加密机、加密卡、IC卡等）。

1.1 使用对象NetSafe Client1.5 for NT软件授权使用者。

1.2 如何使用本手册会使用WINDOWS操作系统，熟悉Web及网络安全的基础知识，熟悉常用代理服务器的使用，掌握签名及验签名的基本原理，了解PKCS的相关知识。

中国工商银行浙江分行特色银企互联系统企业开发手册1.1安全控制介绍对于非NC方式接入的客户✓企业向工行提交交易数据时的安全控制企业ERP与银企互连系统之间使用HTTPS协议通讯。

企业可以选择是否对交易数据进行对称加密，目前系统支持的算法有DES与3DES。

进行对称加密可以防止第三方截获交易的信息。

而加密中需要用到的密钥由企业与工行共同约定。

（加密功能暂不支持）企业需要对其发送的指令数据进行数字签名，签名中使用的证书可以是企业证书也可以是工行证书，其中签名使用的算法是SHA1withRSA。

进行数字签名可以防止第三方假冒企业的行为。

✓工行向企业发送结果信息时的安全控制企业ERP与银企互连系统之间使用HTTPS协议通讯。

企业可选择是否对返回数据进行对称加密，方法与上文相同。

工行对部分关键交易返回信息进行数字签名。

1.2企业端系统环境要求1.2.1软件环境对企业的ERP系统无要求；1.2.2网络环境企业财务系统可以通过专线与中国工商银行银企互连系统互联。

1.2.3企业开发过程描述1.2.3.1企业提交交易请求数据过程（1）企业按照工行提供的xml包格式进行打包，在局域网内通过https协议以POST方式将交易包发送到通讯前置服务器。

http请求格式：action=https://银行通讯前置的地址和加密端口号http包头信息：Content-Type应为application/x-www-form-urlencoded请求数据格式（post方式）：Version=版本号（区分版本时间，暂定0.0.0.1) &TransCode=交易代码（区分交易类型，每个交易固定)&BankCode=客户的归属单位&GroupCIS=客户的归属编码&ID=客户的证书ID（无证书客户可空)&PackageID=客户的指令包序列号（由客户ERP产生，不可重复)&Cert=客户的证书公钥信息（进行BASE64编码；)&reqData=客户的xml请求数据其中：包序列ID、证书ID应根据实际情况进行更改，请求时间为企业发出该交易请求包的当前系统时间。

第 1 章概述银企互联面向大的集团客户，提供与企业ERP系统直连的平台，银企互联面向大的集团客户，提供与企业ERP系统直连的平台，为工行的现金管理服务提供多渠道和客户化支持。

企业ERP系统通过HTTPS协议与工行系统进行连接并向银企互联前置发送数据，数据的接口格式使用标准的xml数据格式，但双方通讯的过程中则需要遵守下文描述的规定。

银企互联前置接到企业数据后进行一系列的检查后完成交易，并将处理结果以企业便于处理的形式返回给企业。

在安全保证方面，通讯层的安全保证是HTTPS协议。

企业如需使用银企互联系统，要办理有关注册手续，并审领证书。

企业进行结算类交易时，如果涉及到授权过程，企业需要在企业网银系统中完成相关授权动作。

银企互连系统将企业提交的支付指令或者授权成功后的指令当作最终转账指令，根据提交指令的证书ID检查收付方帐号等合法性，以保证所提交指令在权限允许范围内进行操作。

第 2 章总体方案介绍2.1总体网络结构图银企互联系统上图企业ERP系统1采用的是非NC方式接入的客户；企业ERP系统2采用的是NC方式接入的客户；2.2企业端安全服务器简介此服务器只对使用NC方式接入的客户有效。

企业端安全服务器被称为NetSafe Client。

它有两个可以配置的端口分别用于加密和签名／验签服务，如下图所示（假设１为加密端口，２为签名／验签端口）。

具体使用时，企业应用向工行提交交易请求时，可以依照http协议向NetSafe Client 的端口１发送请求。

接到请求后，NetSafe Client使用企业证书将http请求包转换成https请求包发往工行端服务器；如果需要对某些交易数据进行签名，则企业应用需要与签名端口建立Socket 连接并将待签名数据发往端口２，然后接收端口２的签名结果，之后再将包含签名信息的交易请求发往端口１而完成整个交易请求过程。

对签名还是验签名请求的区分则是通过http包头来进行。

Content-Type: INFOSEC_SIGN/1.0和Content-Type: INFOSEC_VERIFY_SIGN/1.0分别用于标识签名请求和验签名请求，而Content-Type: INFOSEC_SIGN_RESULT/1.0和Content-Type: INFOSEC_VERIFY_SIGN_RESULT/1.0分别用于标识签名和验签名的返回结果。

中国工商银行银企互联系统接口说明Version中国工商银行电子银行部中国工商银行北京软件研发部2005年07月目录提交包...............................................................网点信息下载...................................................... 提交包...............................................................个人联名卡签权指令................................................1帐户查询1.1单帐户余额查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceOp</opName><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur> 例：RMB<retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>1.2多帐户余额查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryBalanceListOp</opName><ReqParam><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam><ReqParamSet><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><ReqReserved3>请求包备用字段3</ReqReserved3><ReqReserved4>请求包备用字段4</ReqReserved4></ReqParam></ReqParamSet></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryBalanceListOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Account_num>帐号</Account_num><Account_cur>币种</Account_cur><Acc_balance>昨日余额</Acc_balance><Balance>余额</Balance><Usable_balance>可用余额</Usable_balance><Acct_property>帐户属性</Acct_property> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet><ErrSet><Err><Account_num>账号</Account_num><errMessage>出错信息</errMessage></Err></ErrSet></opRep></ICBCYH>1.3当日明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_date>交易日期</Trans_date>（例：yyyy-MM-dd-HH:mm:ss:6位毫秒）共26位<Check_num>凭证号</Check_num><Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet></opRep></ICBCYH>1.4历史明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项（例：yyyyMMdd）<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项（以分为单位，不带小数点）<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Trans_date>交易日期</Trans_date> （例：yyyyMMdd）<Check_num>凭证号</Check_num><Trans_abstr>摘要</Trans_abstr><Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Rec_Account_num>对方账号</Rec_Account_num><Bank_name>开户行名称</Bank_name><Bank1_name>对方行行名</Bank1_name><Unit1_name>对方单位名称</Unit1_name><Trans_type>业务种类</Trans_type> 中文<Yt>用途</Yt><Trans_time>交易时间</Trans_time>（例：yyyy-MM-dd-HH:mm:ss:6位毫秒）共26位其值与当日明细中“交易日期”字段值一致<sign>借贷标志</sign> 中文<RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>1.5现金管理户当日明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccCurDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num> ---必输项<Account_cur>币种</Account_cur><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccCurDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><Account_num>本方帐号</Account_num><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><Trans_time>交易时间</Trans_time> HH:mm:ss<Bank1_code>对方行行号</Bank1_code><Rec_Account_num>对方账号</Rec_Account_num><Amount>发生额</Amount><Yt>用途</Yt><Trans_type>业务种类</Trans_type> 中文<PostScript>附言</PostScript><Rec_Account_name>对方户名</Rec_Account_name><sign>借贷标志</sign> 中文<Trans_abstr>摘要</Trans_abstr><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4> </opResult></opResultSet></opRep></ICBCYH>1.6现金管理户历史明细查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCCashManageAccHisDetailOp</opName><ReqParam><Area_code>地区代码</Area_code><Account_num>帐号</Account_num><Begin_date>起始日期</Begin_date> ---必输项（例：yyyyMMdd）<End_date>终止日期</End_date> ---必输项<Max_amount>最大金额</Max_amount> ---必输项（以分为单位，不带小数点）<Min_amount>最小金额</Min_amount> ---必输项<userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCCashManageAccHisDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode><errMsg>错误描述</errMsg><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult><opResultSet><opResult><TRXTYPE>交易类型</TRXTYPE> 中文<BUSIDATE>交易日期</BUSIDATE> yyyyMMdd<BUSITIME>交易时间</BUSITIME> HH:mm:ss<Account_num>交易帐号</Account_num><Bank_name>本方行名</Bank_name><Trans_type>业务种类</Trans_type> 中文<sign>借贷标志</sign> 中文<Debit_Amount>借方发生额</Debit_Amount><Crebit_Amount>贷方发生额</Crebit_Amount><Balance>余额</Balance><Yt>用途</Yt><CVOUHTYPE>凭证种类</CVOUHTYPE><CVOUHNO>凭证号</CVOUHNO><RECIPACT>对方帐号</RECIPACT><RECIPNAME>对方户名</RECIPNAME><RECIPBNA>对方行名</RECIPBNA><REF>业务编号</REF><OREF>相关业务编号</OREF><BUSCODE>业务代码</BUSCODE><ENSUMMRY>英文备注</ENSUMMRY><ADDINFO>附加信息</ADDINFO><RepReserved3>返回包备用字段3</RepReserved3><RepReserved4>返回包备用字段4</RepReserved4></opResult></opResultSet></opRep></ICBCYH>2转帐支付（逐笔）支付提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCpaySubmitOp</opName><ReqParam><Pay_Dep_name>汇款单位</Pay_Dep_name><Pay_Dep_Acc>汇款帐号</Pay_Dep_Acc> （35位）---必输项<Area_code>地区代码</Area_code><Pay_Dep_branch>汇款单位开户行</Pay_Dep_branch><Rec_Dep_name>收款单位</Rec_Dep_name> （60位） ---必输项<Rec_Dep_Acc>收款帐号</Rec_Dep_Acc> （35位） ---必输项<Rec_Area_Code>收款人地区代码</Rec_Area_Code> 0：它行1：工行<Rec_Dep_branch>收款单位开户行</Rec_Dep_branch>（60位）--必输项<Trans_time>交易时间</Trans_time><Serial_no>指令序号</Serial_no><PayAmt>金额</PayAmt> （18位） ---必输项以分为单位<Account_cur>币种</Account_cur><Pay_Use>用途</Pay_Use> （20位）<Pay_type>汇款速度</Pay_type> 0：普通 1：加急<Author_log_id_1>授权人ID</Author_log_id_1><Author_log_id_2>二次授权人ID</Author_log_id_2> <Submit_Log_id>提交人ID</Submit_Log_id> ---必输项 <Area_name>付款人账户地区名(付款人所在地)</Area_name><Rec_Area_name>收款人账户地区名(收款人所在地)</Rec_Area_name>---必输项收方如果是工行，以《信息对照表》中的地区代码对照表为准<Branch_code>账户分理处号</Branch_code><Pay_Password>支付密码</Pay_Password><User_Rem>备注栏(用户备注) </User_Rem><Pay_NetCode>付款行网点号</Pay_NetCode><Pay_BranchNo>付款行行号</Pay_BranchNo><Pay_BranchId>付款行行标识</Pay_BranchId><Pay_DispsNo>付款行分签号</Pay_DispsNo><Rec_BranchNo>对方行号</Rec_BranchNo><Rec_BranchId>对方行标识</Rec_BranchId><Rec_DispsNo>对方分签号</Rec_DispsNo><PostScript>附言</PostScript><PostScriptFlag>附言标志</PostScriptFlag><Transfer_Type>转帐类型</Transfer_Type><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID（15位）</PackageID> ---必输项<SignTime>签名时间（yyyyMMddhhmmssSSS）</SignTime> ---必输项<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>支付返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCpaySubmitOp</opName><opResult><retCode>返回码</retCode>0-成功1-可疑其他为失败，错误描述在errMsg 中<errMsg>错误描述</errMsg><TranFlag>成功描述</TranFlag><PackageID>包序列ID</PackageID><userID>企业代码</userID><RepReserved1>返回包备用字段1</RepReserved1><RepReserved2>返回包备用字段2</RepReserved2></opResult></opRep></ICBCYH>逐笔支付查询提交包<?xml version="" encoding = "GB2312"?><ICBCYH><opReq><opName>NCQueryPayOrderDetailOp</opName><ReqParam><userID>企业代码（和证书里的一致）</userID> ---必输项<PackageID>包序列ID</PackageID> ---必输项（提交指令中的包ID）<ReqReserved1>请求包备用字段1</ReqReserved1><ReqReserved2>请求包备用字段2</ReqReserved2></ReqParam></opReq></ICBCYH>逐笔支付查询返回包<?xml version="" encoding = "GB2312"?><ICBCYH><opRep><opName>NCQueryPayOrderDetailOp</opName><opResult><retCode>错误返回码错误描述在errMsg 中</retCode>此值只表示该交易是否执行成功，并不代表此笔支付是否成功或失败（非空表示交易执行失败，失败原因见errMsg）。

中国工商银行银企互联系统企业开发手册企业开发手册1 文档属性文档属性文档名称文档版本号文档状态文档编写完成日期作者2 文档变更历史清单文档版本号A0A1变更日期 -11-21 -4-10修改人高小伟高小伟备注给文档加了首页，版本号，作者等信息修正” 企业接收交易响应数据过程” ” 企业接收交易响应数据过程” 对于推广版交易来说，企业收到的同步返回包，64解码后就是明文，不需要验签A2 A3 A4-9-5 -11-1 --7-31高小伟丁孚旌高小伟增加了第8章交易规则修正签名验签接口用例中的内容补充了“第9章大批量指令提交”3 本次修改变更说明序号 1 2 3 4 5变更内容简述第9章：增加了大批量提交接口“人事发工资指令提交”内容中国工商银行银企互联系统企业开发手册 A3 正式稿 -11-1高小伟，丁孚旌目录第 1 章第 2 章第 3 章第 4 章概述 4 总体方案介绍 4 总体网络结构图 4 企业端安全服务器简介 4 安全控制介绍 6 重点说明 7 银企互联——NC方式接入客户 9 企业端系统环境要求 9 软件环境 9 网络环境 9 企业开发过程描述 9第 5 章银企互联——非NC方式接入客户 14企业端系统环境要求 14软件环境 14 网络环境 14 企业开发过程描述 14第 6 章关于通讯证书和银行证书的说明 20 第 7 章磁盘证书拆分 21证书拆分方法 21 证书拆分后流程 21第 1 章概述银企互联面向大的集团客户，提供与企业系统直连的平台，为工行的现金管理服务提供多渠道和客户化支持企业系统通过协议与工行系统进行连接并向银企互联前置发送数据，数据的接口格式使用标准的数据格式，但双方通讯的过程中则需要遵守下文描述的规定银企互联前置接到企业数据后进行一系列的检查后完成交易，并将处理结果以企业便于处理的形式返回给企业在安全保证方面，通讯层的安全保证是协议企业如需使用银企互联系统，要办理有关注册手续，并审领证书企业进行结算类交易时，如果涉及到授权过程，企业需要在企业网银系统中完成相关授权动作银企互联系统将企业提交的支付指令或者授权成功后的指令当作最终转账指令，根据提交指令的证书ID检查收付方帐号等合法性，以保证所提交指令在权限允许范围内进行操作第 2 章总体方案介绍总体网络结构图/企业系统1企业系统2/服务器银企互联系统上图企业系统1采用的是非NC方式接入的客户；企业系统2采用的是NC方式接入的客户；企业端安全服务器简介此服务器只对使用NC方式接入的客户有效企业端安全服务器被称为它有两个可以配置的端口分别用于加密和签名／验签服务，如下图所示结算类交易请求包加密签名交易请求包6、交易返回包交易返回包1签名请求包2签名结果查询类具体使用时，企业应用向工行提交交易请求时，可以依照协议向交易返回包交易请求包加密交易请求包交易返回包的端口１发送请求接到请求后，使用企业证书将请求包转换成请求包发往工行端服务器(如上图“查询类”)；如果需要对某些交易数据进行签名，则企业应用需要与签名端口建立连接并将待签名数据发往端口２，然后接收端口２的签名结果，之后再将包含签名信息的交易请求发往端口１而完成整个交易请求过程(如上图“结算类”)对签名还是验签名请求的区分则是通过包头来进行-: _/和-: __/分别用于标识签名请求和验签名请求，而-: __/和-: ___/分别用于标识签名和验签名的返回结果为方便起见，可以将的两个服务端口逻辑地称为两台服务器，的加密服务器和签名服务器安全控制介绍对于NC方式接入的客户企业向工行提交的交易数据，必须通过企业方的进行与工行服务器的连接，接口确定需要签名的数据也必须由的签名服务器签名后组成规定的数据包格式后，通过提交工行，这样可以保证企业数据以及相关信息不被恶意篡改数据全部由负责转发，使成为架设在企业现场的工行接入服务器而企业与工行之间安全的连接，由和工行安全代理服务器保证；工行接收到企业提交过来的部分关键交易数据后，需要解密并验证企业的数字签名，以防止第三方假冒企业的行为对于非NC方式接入的客户企业向工行提交交易数据时的安全控制企业与银企互联系统之间使用协议通讯企业可以选择是否对交易数据进行对称加密，目前系统支持的算法有与3进行对称加密可以防止第三方截获交易的信息而加密中需要用到的密钥由企业与工行共同约定企业需要对其发送的指令数据进行数字签名，签名中使用的证书可以是企业证书也可以是工行证书，其中签名使用的算法是1进行数字签名可以防止第三方假冒企业的行为工行向企业发送结果信息时的安全控制企业与银企互联系统之间使用协议通讯企业可选择是否对返回数据进行对称加密，方法与上文相同工行对部分关键交易返回信息进行数字签名第 3 章重点说明格式要支持业界公认的标准格式，例如：< />等同于<></>；上送数据格式尽量简单，避免使用等文本格式所有的交易请求包中“包序列ID”字段由企业产生，产生规则为当前日期＋7位序列号在一个企业代码下当日包序列ID必须唯一工行处理完毕之后将该字段原值返回，即所有的交易返回包中“包序列ID”字段转帐交易请求包中“签名时间”字段，格式为签名时间应为北京时间签名时间如果与交易请求到达工行服务器时的北京标准时间误差过大，交易将无法进行此措施将可以有效地防止黑客采用重放攻击进行干扰帐务活动的行为同一笔交易如果因为网络不正常等因素需要重新提交时，要修改转账交易请求包的“签名时间字段”并重新签名所有请求包和返回包中备用字段的使用主要是出于对今后扩展的考虑，如果以后需要增加企业上送的项目或者返回给企业的信息，不必再改变交易包格式目前对企业请求包来说这些备用字段的值可以送空；企业对银行返回包中的备用字段也不必作处理请求包中的备用字段标签为“*”，返回包中的备用字段标签为“*”查询历史明细返回数据包中交易时间数值如为空，则说明该笔指令是银行的计息交易明细支付查询指令接口，方便企业对可疑、有疑问或处理完毕的转帐指令进行查询企业提交要查询的结算请求的包序列ID，工行返回该笔转帐指令的基本信息和状态本接口说明中所有涉及金额的字段都是以分为单位如企业系统需要代理汇兑功能则企业应用需同步开发网点信息下载交易，以便为代理汇兑交易中收方为它行情况时提供工行网点名称否则，无需开发网点信息下载交易在网点信息下载功能中，由于下载数据过大且数据不会经常更新，所以此交易控制了企业每日下载次数目前暂定次数为每日2次个人联名卡签权指令只支持币种是人民币的账号/卡号企业端传输数据时，指定编码方式为银企互联提交包中包含“<>签名时间</>”此标签的，说明该交易需要进行签名处理企业端的程序需要对银行返回的数据有可扩展性，以便适应今后业务的不断发展银企互联系统支持两种接入方式，客户可以任何选择一种第一种：使用第三方NC 软件方式接入银企互联系统；第二种：使用非NC方式企业直接接入银企互联系统；一些接口中，返回包分文件级返回包和指令级返回包两种文件级返回包是作为客户请求的响应信息同步返回的而指令级返回包是银行主动发起的异步返回信息，表示指令处理的结果，指令级返回包首先会返回整批指令的处理结果，然后对于其中指令状态非最终状态的指令，银行会实时更新每一条指令的状态，然后再每条分别以指令级返回包的格式返回给客户建议客户使用/协议/及其以下协议版本可能无法正常发送指令到银行端下面将区分两类客户分别对接入方式等相关信息进行说明第 4 章银企互联——NC方式接入客户企业端系统环境要求软件环境对企业的系统无要求；工行企业端证书服务器软件需安装在一台PC机上网络环境企业财务系统通过局域网与工商银行提供的连接；企业端的可以通过专线或与中国工商银行银企互联系统互联企业开发过程描述企业提交交易请求数据过程企业提交的交易分为两大类：查询类和结算类 1、查询类：企业按照工行提供的包格式进行打包，在局域网内通过协议以方式将交易包发送到的安全协议服务器请求格式：=”://客户端的地址和加密端口号//?=证书ID&=包序列ID &=请求时间”请求包头信息：-应为/x---请求数据格式：=版本号将包加密后按照协议，通过互联网/专线发送到银行端的；将交易请求送银企互联系统进行处理企业工行2、结算类：企业按照工行提供的包格式进行打包，在局域网内与的签名端口建立连接，通过此连接向签名端口发送数据包包头中需包含“-”和“-”两个属性其中“-:”后面是需要签名的二进制数据包的长度，“-:”后面是需要签名的标记，为_/请求格式：=”://客户端的地址和签名端口号”请求数据格式：结算类请求提交的包对包进行签名后，通过协议将签名结果返回给企业系统如签名成功<>标签与</>标签之间的部分为签名结果返回的签名包如下： <> <><>签名结果</> <>0</> </> <><>………… 0=</> </> </>企业按照工行提供的包格式进行打包，在局域网内通过协议以方式将交易包发送到的安全协议服务器请求格式：=”://客户端的地址和加密端口号//?=证书ID&=包序列ID &=请求时间”请求数据格式：=版本号将企业送来的签名包加密后按照协议，通过互联网/专线发送到工行端的，再发往工行网银进行处理企业NC提交参考范例：企业接收交易响应数据过程企业接收到数据包的格式：=交易返回包或 =错误代码步骤：判断返回数据中是否是：如果是：根据错误代码做相应处理，结束错误代码的含义参见接口说明文档中的附录如果否：企业接收到数据包的格式：=交易结果包；企业根据先进行64解码，签名返回包按照格式拆分出明文和密文，验签正确后对明文得到明文后，按工行提供的包格式进行解包对于单笔提交类指令，返回的包格式按照指令级返回包格式来处理，多笔则按照文件级返回包格式来处理企业接收银行主动返回过程请求格式：=”://客户服务器的地址和端口号” 请求数据格式：=版本号算作1位长度；分隔符：；密文：明文经过签名后的数据并做64编码；如果不需要签名，则直接送明文；以上数据经过拼接后，再进行64编码得到最终的数据按照以上格式将请求数据发送到企业；此格式返回的数据是不经过NC的，是银行直接发给企业的系统；如有使用，企业需要在内管注册或者修改集团信息时填入企业用于接收银行反馈的地址，标准格式是；编解码方式查看报文版本号说明当存量接口无法满足客户需求且无备用字段可扩充时，进行接口版本号的升级升级后的接口保持不变，提升，使用新接口的客户，请求报文应与相应版本的报文格式保持一致同时，要求使用新版本的客户系统按照自动扩展解析方式调用开发即：企业客户根据银企互联接口数据返回包定义的“是否可选”标记来判断解析原则，如果标志为“否”的，需要客户系统校验标签节点，如果为“是”的，客户系统可根据自身需求决定是否拓展第 5 章银企互联——非NC方式接入客户企业端系统环境要求软件环境对企业的系统无要求；网络环境企业财务系统可以通过专线与中国工商银行银企互联系统互联企业开发过程描述企业提交交易请求数据过程企业按照工行提供的包格式进行打包，在局域网内通过协议以方式将交易包发送到银行前置机请求格式：=://银行通讯前置的地址和加密端口号? 请求数据包头信息：-应为/x---请求数据格式：=版本号算作1位长度；分隔符：；密文：明文经过签名后的数据并做64编码；如果不需要签名，则直接送明文；以上数据经过拼接后，再进行64编码得到最终的数据以上每项请求参数的值均应做一次编码，然后按照以上格式将请求数据发送到工行；企业接收交易响应数据过程企业接收到数据包的格式：=交易返回包或 =错误代码=交易返回包结构：如果交易返回包进行了签名，则结构为：数字字符串：长度10位，代表明文数据长度，不足10位左补0；明文：长度可变，需要上面的数据指明，双字节字符算作1位长度；分隔符：；密文：明文经过签名后的数据；如果交易返回包没有签名，则结构为：明文；不论是否签名，交易返回包均进行了64编码；步骤：判断返回数据中是否是“=”打头：如果是：根据错误代码做相应处理，结束错误代码的含义参见接口说明文档中的附录如果否：企业接收到数据包的格式：=交易结果包企业根据先进行64解码，签名返回包按照格式拆分出明文和密文，验签正确后对明文，得到明文，然后按工行提供的包格式进行解包对于单笔提交类指令，返回的包格式按照指令级返回包格式来处理，多笔则按照文件级返回包格式来处理企业接收银行主动返回过程请求格式：=”://客户服务器的地址和端口号” 请求数据格式：=版本号算作1位长度；分隔符：；密文：明文经过签名后的数据并做64编码；如果不需要签名，则直接送明文；以上数据经过拼接后，再进行64编码得到最终的数据按照以上格式将请求数据发送到企业；此格式返回的数据是银行直接发给企业的系统；如有使用，企业需要在内管注册或者修改集团信息时填入企业用于接收银行反馈的地址，标准格式是；编解码方式查看企业签名验签过程在银企互联中，对于指令体的签名与验签工作由纯版工行签名验签接口完成的本文档对在专业版银企互联中使用的接口作出描述同时提供了一套纯版的从企业发送指令到工行系统和从工行系统接收处理结果的例子程序从企业发送指令到工行系统的例子中包括了两方面的内容：用企业的数据层私钥对数据进行签名，然后用工行的通讯层公钥进行通讯认证；从工行系统接收处理结果的例子中包括了两方面的内容：用企业的通讯层私钥要求通讯认证，然后用工行的数据层公钥进行数据的验签使用这种接入方式的客户只能使用磁盘证书；该磁盘证书需要拆分，拆分为一对数据层证书，用于签名验签；一对通讯层证书，用于建立与银行的连接拆分方法见第7章企业签名验签方法总体介绍接口包含、_1_02_、、四个文件，使用时需要把这四个文件放置到的目录中该接口建议的版本为以上接口使用的详细说明[] ([][] [] )用算法对一段消息签名:- 为口令保护的私钥 - 为待签名消息 - 为待签名消息的长度 - 为私钥保护口令:如果成功返回签名结果如果失败返回:- - - -([] [] [] )用算法对一段签名进行验证:- 为证书 - 为被签名的消息 - 为被签名消息的长度 - 为签名的结果:如果成功返回0如果其它则失败:- - -附件说明1．，是一套客户证书的公钥与私钥，保护口令是2． 3．明4．附件如下是一个演示各个接口使用方式的测试程序文件夹指导企业开发的例子程序；《使用说明》例子的使用说签名验签接口及用例服务器建立开发支持请参考上面附件中\\\\开发《使用说明》文档介绍了开发方法 64编解码方法参考建议使用提供的64编解码方法实现/*** 64解码* s:需要解码的数据 * 解码后的数据 */ 64( s) { } /*** 64解码* s:需要解码的数据 * 解码后的数据 */ [] 64( s) { }(s == );= ; { }(s); ; } ( e) { (s == );= ; { }[] b = (s); (b); ;} ( e) {/*** 64编码* s:需要编码的数据 * 编码后的数据 */ 64([] s) { }(s == );= ; { }(s); ; } ( e) {报文版本号说明当存量接口无法满足客户需求且无备用字段可扩充时，进行接口版本号的升级升级后的接口保持不变，提升，使用新接口的客户，请求报文应与相应版本的报文格式保持一致同时，要求使用新版本的客户系统按照自动扩展解析方式调用开发即：企业客户根据银企互联接口数据返回包定义的“是否可选”标记来判断解析原则，如果标志为“否”的，需要客户系统校验标签节点，如果为“是”的，客户系统可根据自身需求决定是否拓展第 6 章关于通讯证书和银行证书的说明如果企业客户需要接收银行的主动反馈信息，请注意以下内容： 1、对于申请IC卡或者的硬方式数据证书的客户，需要在电子银行内部管理系统的“企业客户管理-客户通讯证书ID管理”下载一个通讯证书此证书为磁盘证书，用于银行与客户建立通讯使用；签名证书请客户继续使用硬证书；此磁盘证书需要拆分，拆分方法请见第7章2、所有客户需要从银行端获取两张证书，一张是：银行端将对应的数据层公钥文件发给客户，以便银行与客户主动建立链接认证使用；另一张是：银行端还要将客户验签使用的公钥证书在客户注册时也要发给客户，以便客户对银行返回的部分交易的数据进行验签使用第 7 章磁盘证书拆分证书拆分方法见以下附件中的《证书制作流程》，拆分工具也在其中证书拆分后流程企业证书拆分所得、和文件由客户保存，分别是数据层公钥、数据层私钥和通讯层私钥；第 8 章交易规则1 对于多笔提交交易，判断银行返回文件级返回包的是否为0；如果不为0，说明整批校验不通过，银行不会处理指令此类情况下，客户可通过对应交易的查询接口发起该笔指令的查询请求，如返回‘所查指令不存在’类报错，则此笔指令确认失败；如果为0，表示银行接收成功客户可以通过接收银行反馈或者主动查询指令详细信息，进一步确认指令处理状态(一般情况下6代表失败，7代表成功，其他为中间状态具体以接口文档为准)2 对于单笔提交交易，一般银行实时处理，返回指令级返回包用户可直接根据交易的指令状态判断指令处理情况第 9 章大批量指令提交背景XX年8月份版本，优化程序支持客户一次最大提交笔报文实现方法1 对于提交类请求报文，需要客户将<rd>(循环区)的指令压缩并64编码后，放置到<></>节点，成为新的请求报文并且增加请求参数=1举例：压缩前的报文格式：<? ="" = "GB"?> <> <eb> <> <>交易代码</> <>集团号</> <>归属银行编号</> <ID>证书ID</ID> <>交易日期</> <>交易时间</> <>指令包序列号</> </> <> <>联机批量标志</> <>入账方式</> <>总笔数</><>总金额</> <>签名时间</>。

1、前言此文档是工银集团客户信息系统批量公共接口标准。

2、批量通讯方式通讯方式：采用 SFTP通讯方式FTP地址：端口：21 （此为集成测试环境地址，生产地址以实际为准）用户名：工银安盛： icbcaxa工银国际: icbci工银瑞信： icbccs工银泰租： icbctl工银租赁： icbcl工银金融： icbcfs文件上传地址：各子公司通过自己的用户名登录到各自的目录，将文件上传至该目录工银瑞信：/home/scis/data/ICBCCS/receivefiles/from_subcorp/文件下载地址：各子公司通过自己的用户名登录到各自的目录，获取系统生成的返回文件。

工银瑞信：/home/scis/data/ICBCCS/sendfiles/send_subcorp/权限：各子公司用户只有对自己的文件上传目录有读写权限，文件下载目录有读权限，对其他子公司的文件上传，下载目录没有任何操作权限返回文件保留期限：1个月3、批量处理规则批量处理时间：工银瑞信：待定文件完整性说明：在TXT文件上送完毕后必须上送CHK文件，一个文件对应一个CHK文件，当系统检测到CHK文件时表示文件已上送完毕，请务必确保CHK文件要在文件上送完毕后再上送，CHK文件内容为空即可。

同理文件下载时也必须检测到系统生成的CHK 文件后才能进行下载。

4、文件接口4.1.集团子公司客户信息开户维护接口4.1.1.集团子公司客户信息开户维护接口文件（子公司发起）请求文件名，：1.SCIS + 10位子公司代码（CorpCode）+3位产品系统编号（AppNo）+8位日期+4位文件序号（左补0）+.txtCHK文件名：SCIS + 10位子公司代码（CorpCode）+ 3位产品系统编号（AppNo）+8位日期+4位文件序号（左补0）+.CHK（需要和子公司沟通）文件由子公司通过SFTP上传给客户信息系统产品系统编号AppNo 目前字典值工银瑞信子公司代码：00工银瑞信系统编号：004请求文件的内容ITEM项请参见联机报文说明文档（见附件）内容，去掉XML头后只保留PUBLIC和PRIV ATE的内容，一个ITEM为一个请求报文，一个TXT文件或者XML文件由大量的ITEM组成。

B2C支付接口v1.0.0.3第 1 章业务说明第 2 章商户接口2.1 支付接口2.1.1 支付接口表单定义2.1.2 tranData2.1.3 tranData格式定义 (10)2.1.4 表单样例 (11)2.2 通知接口 (14)2.2.1 通知接口表单定义 (14)2.2.2 notifyData数据定义 (15)2.2.3 notifyData格式定义 (17)2.2.4 表单样例 (18)2.3 说明 (20)第 3 章安全API说明 (21)第 4 章开发步骤 (21)第 1 章业务说明B2C在线支付接口实现工行个人网银客户在工行B2C商户网站进行消费支付的业务处理。

新的1.0.0.3版本同原先版本的主要区别在于通知消息方式的改变。

原1.0.0.0版本和1.0.0.1版本（扩充语言字段以支持英文版）在订单中要求商户选择通知方式，即1、需要银行通知交易结果，2、不需要银行通知交易结果而是商户主动查询；当需要通知时，需要在订单中提供商户接收银行通知地址，当银行处理结束后，会在银行的后台服务器请求商户的此地址，将交易结果用http连接post表单形式提交给商户，然后返回客户交易结果页面。

新的1.0.0.3版本不再要求商户选择通知方式，和接收银行通知的地址；此版本要求商户在提交订单时，提供交易处理后返回商户的地址，即完成客户从商户转向到银行进行支付，处理后又从银行定向回商户网站的闭环。

在从银行交易页面返回商户时，将交易结果作为表单数据提交到商户此返回地址。

处理的优点：1、强制完成交易闭环；2、无需银行后台发送通知，客户不需要等待商户接收银行通知后才能看到交易结果页面，缩短响应时间；3、通知方式不再局限于http连接和80端口，返回商户的地址可以使用https方式和其他商户支持的端口，提高安全性；4、银行作为交易的一方，支持众多商户和客户时，存在一定的带宽和服务器处理压力，使用客户返回商户方式提供交易结果，可有效减少交易掉单现象，只要客户到了银行的结果页面，如果还出现掉单问题，则可能是客户和商户的通讯等方面的问题。

银企对接企业前置机应用安装手册部门：电子渠道开发部网上银行项目组文档编号: _IG_01版本号:目录一、银企对接企业前置机系统运行环境21 硬件环境：22 软件环境：3二、系统安装配置31 操作系统的安装32 Sun JDK 运行环境的安装与配置33 应用服务器安装配置33.1 设置JAVA_HOME环境变量。

344 usb安全模块安装与系统配置54.1 安装usb key的驱动程序54.2 有关usk key的配置和须知事项55 应用程序发布66 系统配置666.2 生成网银服务器证书Base64格式文件76.3 修改HOSTS配置文件错误!未定义书签。

8三、附录91 附录A ---- 92 附录B ---- 9104 附录D ---- 查看usbkey颁发者115 附录F ---- hosts文件参照错误!未定义书签。

➢本手册是根据中国银行网上银行银企对接前置机系统1.1编写的应用系统安装手册。

➢由于编者水平有限，错误和疏漏在所难免，敬请读者谅解。

随着银企对接系统的更新和开展，本手册的内容将不断修改和完善。

一、银企对接企业前置机系统运行环境1 硬件环境：➢PC服务器或PC机一台建议配置：cpu〔处理器〕双核Xeon〔至强〕或酷睿2双核Memory〔内存〕 1024M以上USB接口 V2.0或以上，至少1个➢USB-Key 一个〔按照中行要求定制的带编号的key〕2 软件环境：➢WINDOWS2000 server,Windows XP，Windows 2003server➢通讯协议：TCP/IP➢Sun jdk1.5.0(推荐)➢应用服务器：(必须)⏹Apache Tomcat 6.0.16(推荐)⏹其他应用服务器二、系统安装配置本安装手册中的几个约定：➢约定以%System_path%表示操作系统安装路径➢约定以%JAVA_HOME%表示JDK安装路径➢约定以%CATALINA _HOME%表示Apache Tomcat安装路径1 操作系统的安装➢安装WINDOWS2000 server 与补丁PACK 4〔或WindowsXP SP2或Windows2003 Server〕，尽量将所有补丁全部安装2 Sun JDK 运行环境的安装与配置➢详细安装过程请参照安装文档与附录A。

第1章概述.............................................................................. 错误!未指定书签。

第2章总体方案介绍.............................................................. 错误!未指定书签。

2.1总体网络结构图.......................................................... 错误!未指定书签。

2.2企业端安全服务器简介.............................................. 错误!未指定书签。

2.3安全控制介绍.............................................................. 错误!未指定书签。

第3章重点说明...................................................................... 错误!未指定书签。

第4章银企互联——NC方式接入客户................................. 错误!未指定书签。

4.1企业端系统环境要求.................................................. 错误!未指定书签。

4.1.1软件环境............................................................ 错误!未指定书签。

4.1.2网络环境............................................................ 错误!未指定书签。

4.1.3企业开发过程描述............................................ 错误!未指定书签。