《大宗商品电子交易市场银行接口转账协议规范.docx》由会员分享，可在线阅读，更多相关《大宗商品电子交易市场银行接口转账协议规范.docx（15页珍藏版）》请在金锄头文库上搜索。
1、大宗商品电子交易市场银行接口转账协议规范提供给专研行业技术发展和交易市场的技术部内部人员参考之用。 文件状态： 草稿 正式发布 正在修改文件标识：银行转帐协议规范当前版本：V2.0作 者：黄东完成日期：2008-08-15版本号*变化状态简要说明日期变更人审核日期审核人V2.0M协议修订2008-08-15黄东V2.1A协议修订，增加对金额处理的说明。即发送方金额*100，接收方金额除以100，使金额不出现小数位。加入帐户图。增加大数据量文件格式定义。2008-10-14蒋加君V2.2M50010增加“收益类型”字段2008-10-28蒋加君V2.3M50003,50004,50011增加“开
2、户银行”字段2008-10-31V2.4M50015 增加 “查询日期”字段2008-11-3V2.5M修改20020，10009。删除20016，20022。增加交易说明，帐户结构说明。2008-12-9*变化状态：A增加，M修改，D删除第一章 通讯协议格式1.1、通讯方式。从Client到通信服务器的通信在底层符合TCP/IP协议规范，其应用协议是针对转帐特点而设计的。双方通信采用异步通信方式，采用短连接方式，双方均可发起指令，当一方发起指令后在处理完毕后会主动断开。通信工具采用MTI（Transaction Middleware System）提供的包传输协议，每一段数据组成一个数据包，
3、各段数据采用各个数据包同时连续发送的方法实现。1.2、协议规范 在本协议中无论字符，数字全部采用字符串方式传送。为避免金额出现小数，所有金额在发送时都乘以100后发送，接收方除以100后进行处理。如转帐资金为 1000.23元，数据传输时即为100023，不采用二进制或其它格式存放数据。包头中各字段顺序固定，对于有长度要求的，长度不够时采用右补空格 填充，如100002A 。包体中对数据长度不做具体要求，有具体的分割符号来区分。1.3、协议包格式约定1.3.1包头结构定义 MtiHead = Packed RECORD HeadType：Array0.4 of CHAR; /数据帧类型 Sub
4、Type：Array0.1 of CHAR; /子数据帧类型 HeadVer：Array0.1 of CHAR; /协议版本号 目前版本必须为字符20 ReqMac：Array0.11 of CHAR; /请求方MAC地址 ReqID：Array0.19 of CHAR; /请求方标识，应答时原样返回 DataLen：Array0.4 of CHAR ; /数据帧长度 NextFlag：Array0.0 of CHAR; /是否有下一包数据 N 没有，Y有 EncFlag：Array0.0 of CHAR; /加密标志Y加密 N不加密 BankID：Array0.2 of CHAR; /银行代
5、码 RtnNO： ARRAY0.4 of CHAR; /返回码 00000为成功，其他为失败 DataCol ：ARRAY0.0 of BYTE; /包体数据字段列数 没有数据返回时填0x00 DataRow ：Array0.3 of CHAR ; /包体数据行数 没有数据返回时填0000 ExWaterID：Array0.13 of CHAR; /流水号 系统唯一流水号CommInfo：ARRAY0.19 of CHAR; /保留信息 CommInfo0=1资金管理客户端/ CommInfo0=2交易客户端 CheckNum ：ARRAY0.4 of CHAR; /校验和 end;说明：He
6、adType是系统所有交易类型的定义，如90001,90002等 SubType：是系统所有交易子类型定义，子类型不唯一，只能和主类型配合一起使用 DataLen：是数据域的长度，不包括包头数据长度 NextFlag：当有多包数据要传输时，如果有下一包数据Y，否则N ,如果只有一包或没有数据包填N RtnNO：返回码 00000为成功，其他为失败 EncFlag：加密标志，代表数据域是否采用加密处理 ExWaterID: 系统唯一标识 BankID银行代码：银行代码银行名称001浦发行002工行003招行004农行005建行006交行007广发行008中国银行009商行CheckNum包头数据
7、校验和，具体校验算法另行定义 数据包结构具体如下表所示：项目数据包头HeadType数据帧类型SubType子数据帧类型HeadVer协议版本号 目前版本必须为字符20ReqMac请求方MAC地址ReqID请求方标识，应答时原样返回DataLen数据帧长度NextFlag是否有下一包数据 N 没有，Y有EncFlag加密标志0x01加密 0x00不加密BankID银行代码RtnNO返回码DataCol包体数据字段列数DataRow包体数据行数ExWaterID流水号CommInfo保留信息CheckNum校验和包体DataPackUSERIDCHANGEMONEYINOUTTYPE000130
8、05.23100023005.23100033005.2311.3.2包体结构定义包体结果说明：1.包体全部内容均为字符串。2.为各元素之单的分割符,表示一个ACSCII1的字符。目前定义为 0x083.每个元素的顺序可以任意改变，如某元素信息不存在，表示为空值，但列名必须存在。4.应答（错误）时，包体返回 错误码返回码（RtnNo），错误返回信息（RtnInfo）。5.应答（正确）时，包体不包含返回码和返回信息，只包含协议的返回信息并填包头RtnNO为00000，如果没有返回信息，则包头的DataCol为0x00，DataRow为00000，包体为空（不填返回数据，只填包头RtnNO为000
9、00）。6.如果不需要验证密码,则密码填入十个星号(*)7. 目前金额处理为 实际金额*100 使金额不出现小数位，例如：金额5623.12 ，协议中发送的金额为 562312 。即发送方发送时金额*100，接收方处理金额时将金额除以100。请求与应答数据的如以下格式：请求方或应答方：第1行：列名1列名2.列名n第2行：数据1数据2.数据n第3行：数据1数据2.数据n第N行：. 举例如下：请求：CustTradeIDChangeMoneyMoneyStyMemo00013005.23100023005.2311005200033005.231应答（错误）：RtnNoRtnInfo10001资金
10、密码校验失败应答（正确有返回数据）：CustTradeIDChangeMoneyMoneyStyMemo00013005.231应答（正确无返回数据）：1.3.3银行具体帐户结构图市场人民币总帐户交易商资金子帐户交易商1交易商N交易资金子帐户担保金子帐户交易资金子帐户担保金子帐户手续费子帐户代收代付子帐户交易市场收益子帐户利息结算子帐户市场结算帐户1市场人民币总帐户：市场在银行开设的资金监管帐户。下设“交易商资金子帐户” “交易市场收益子帐”虚拟帐户。 交易商资金子帐户：为各交易商所有资金总和。 交易市场收益子帐：市场的所有收益总和。市场可已将此帐户中资金划转到“市场结算帐户”。其中包括手续费
11、子帐户，代收代付子帐户，利息结算子帐户。2市场结算帐户：市场在银行开设的非监管帐户，此帐户资金市场可以自由划转。1.3.4系统结构图第2章 元素列表定义2.1元素约定接口中元素名不区分大小写2.2元素列表元素名元素含义字符说明HeadType数据帧类型C5定长为五位数字，1和2开头代表银行发起，5，6代表市场发起SubType子数据帧类型C2ReqID请求方标识C20用于标记请求时的流水号，在应答时直接原样返回HeadVer协议版本号C2协议版本号 目前版本必须为20ReqMac请求方MAC地址C12DataLen数据帧长度C5不包括包头数据长度NextFlag是否有下一包数据C1N 没有，Y
12、有EncFlag加密标志C1Y加密 N不加密DataCol包体数据字段列数C1DataRow包体数据行数C4ExWaterID流水号C14系统唯一标识DelWaterID被冲正流水号C14用于冲正，被冲正交易的流水号RtnNo返回码C5RtnInfo返回信息C50CommInfo保留信息C20CheckNum校验和C5PinKey主密钥C20MacKeyMAC密钥C20BankID银行编号C3001 浦发行002 工行003 招行004 农行005 建行006 交行007 广发行008 中国银行009 商行BankIDIn转入银行编号C3BankSubNo银行分行号C10BankName银行名称C50BankPosNo银行网点C20BusinType业务类型C10-普通转帐OperID柜员编号C10银行
