大宗商品电子交易市场银行接口转账协议规范.docx

大宗商品电子交易市场银行接口转账协议规范提供给专研行业技术发展和交易市场的技术部内部人员参考之用。 文件状态： 草稿 正式发布 正在修改文件标识：银行转帐协议规范当前版本：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增加“开户银行”字段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）提供的包传输协议，每一段数据组成一个数据包，各段数据采用各个数据包同时连续发送的方法实现。1.2、协议规范 在本协议中无论字符，数字全部采用字符串方式传送。为避免金额出现小数，所有金额在发送时都乘以100后发送，接收方除以100后进行处理。如转帐资金为 1000.23元，数据传输时即为100023，不采用二进制或其它格式存放数据。包头中各字段顺序固定，对于有长度要求的，长度不够时采用右补空格 填充，如100002A 。包体中对数据长度不做具体要求，有具体的分割符号来区分。1.3、协议包格式约定1.3.1包头结构定义 MtiHead = Packed RECORD HeadType：Array0.4 of CHAR; /数据帧类型 SubType：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; /银行代码 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;说明：HeadType是系统所有交易类型的定义，如90001,90002等 SubType：是系统所有交易子类型定义，子类型不唯一，只能和主类型配合一起使用 DataLen：是数据域的长度，不包括包头数据长度 NextFlag：当有多包数据要传输时，如果有下一包数据Y，否则N ,如果只有一包或没有数据包填N RtnNO：返回码 00000为成功，其他为失败 EncFlag：加密标志，代表数据域是否采用加密处理 ExWaterID: 系统唯一标识 BankID银行代码：银行代码银行名称001浦发行002工行003招行004农行005建行006交行007广发行008中国银行009商行CheckNum包头数据校验和，具体校验算法另行定义 数据包结构具体如下表所示：项目数据包头HeadType数据帧类型SubType子数据帧类型HeadVer协议版本号 目前版本必须为字符20ReqMac请求方MAC地址ReqID请求方标识，应答时原样返回DataLen数据帧长度NextFlag是否有下一包数据 N 没有，Y有EncFlag加密标志0x01加密 0x00不加密BankID银行代码RtnNO返回码DataCol包体数据字段列数DataRow包体数据行数ExWaterID流水号CommInfo保留信息CheckNum校验和包体DataPackUSERIDCHANGEMONEYINOUTTYPE00013005.23100023005.23100033005.2311.3.2包体结构定义包体结果说明：1.包体全部内容均为字符串。2.为各元素之单的分割符,表示一个ACSCII1的字符。目前定义为 0x083.每个元素的顺序可以任意改变，如某元素信息不存在，表示为空值，但列名必须存在。4.应答（错误）时，包体返回 错误码返回码（RtnNo），错误返回信息（RtnInfo）。5.应答（正确）时，包体不包含返回码和返回信息，只包含协议的返回信息并填包头RtnNO为00000，如果没有返回信息，则包头的DataCol为0x00，DataRow为00000，包体为空（不填返回数据，只填包头RtnNO为00000）。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资金密码校验失败应答（正确有返回数据）：CustTradeIDChangeMoneyMoneyStyMemo00013005.231应答（正确无返回数据）：1.3.3银行具体帐户结构图市场人民币总帐户交易商资金子帐户交易商1交易商N交易资金子帐户担保金子帐户交易资金子帐户担保金子帐户手续费子帐户代收代付子帐户交易市场收益子帐户利息结算子帐户市场结算帐户1市场人民币总帐户：市场在银行开设的资金监管帐户。下设“交易商资金子帐户” “交易市场收益子帐”虚拟帐户。 交易商资金子帐户：为各交易商所有资金总和。 交易市场收益子帐：市场的所有收益总和。市场可已将此帐户中资金划转到“市场结算帐户”。其中包括手续费子帐户，代收代付子帐户，利息结算子帐户。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有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银行操作人员编号CompBankAcctNo市场银行帐号C40Nationality国籍或地区C3CustBankAcctNo客户银行帐号C40NCustBankAcctNo客户新银行帐号C40CustBankPass客户银行密码C10NCustBankPass新客户银行密码C10BankEnableMoney银行可用资金C20客户可用资金BankEOutMOney银行可取资金C20客户可取资金BankWaterID银行流水号C14CompId市场公司编号C8CompIdIn转入市场公司编号C8SubCompId市场分公司编码C8SubCompIdIn转入市场分公司编码C8CustTradeID客户交易账号C40CustTradePwd客户交易密码C10CustMoneyPwd客户资金密码C10NCustMoneyPwd客户新资金密码C10CustOpenType客户类别C10个人,1机构CompEnableMoney市场可用资金C20CompOutMoney市场可取资金C20可转资金BailMoney保证金C20GoodMoney货款C20TrasComm手续费C20CompWaterID市场流水号C14FirmID会员编号C15FirmName客户名称C100支持存放机构户名称CardIDType客户证件类型C11身份证,0其它, 8组织机构代码,9营业执照CardID客户证件号C30PostCode邮政编码C10CustAddress客户地址C100TelNo电话号码C20FaxNo传真号码C20MoveTel手机号码C20Email电子邮件C20Memo业务备注C200相当于备注元素OrderCode转帐预约号C10GainMoney利息C20保留利息税的利息资金TaxGainMoney利息税C20市场结息时用TradeDate交易日期C8TradeTime交易时间C6MoneyType币种C10 人民币,1 美元 ,2 港币ChangeMoney变动资金C20DifBalance差额资金C20StartDate查询起始日期C8EndDate查询结束日期C8WaterState流水状态C1含义：0成功、1存疑、2失败、3已冲正MoneySty资金类型C10保证金,1货款 默认0BankTCommMoney银行手续费帐户资金C20BankMidCountMoney银行代收代付帐户资金C20GainAccMoney利息结算帐户资金C20TradeStart交易发起方C10 市场发起,1 银行发起TradeType交易类型C10 市场转银行,1 银行转市场LimitMoney出金限额C20新加入 市场内部使用AccDB访问数据库标识C50新加入 市场内部使用SqlStrSql语句C200新加入 市场内部使用 多条语句用#$D#$A分隔ProName存储过程名称C50新加入 市场内部使用Param存储过程参数C200新加入 市场内部使用RetData变体数据0新加入 市场内部使用 不限制长度ProRet存储过程返回值C200新加入 市场内部使用 不限制长度IsMult是否为多条语句(0 单条,1 多条)C1CheckState审核状态C10未审核,1终审核,2初审,3初始否决,4终审否决InComeType收益类型C10手续费,1代收代付,2利息AccBankName开户银行名称C100中国银行新协议增加NAccBankName新开户银行名称C100中国银行新协议增加QueryDate查询日期C82.3返回码定义要求银行和市场常见返回应遵照以下约定：返回码返回信息返回码返回信息00000交易成功31001该资金账号已挂失10001资金密码校验失败31002该资金账号已冻结10002资金账户余额不足31003该币种已经存在10003累计资金超出最大限定31004该代理人已经存在10004银行流水号重复31005该代理人不存在10005被冲正流水不存在(冲正交易)31190该币种不存在10006原流水已经冲正(冲正交易)31200当天有业务发生不可变更帐户信息10007与原流水信息不符(冲正交易)31240该银行账户状态错10008资金账户余额不足,不允许冲正31260无此客户账号10009身份证号码不一致31270该客户账号已存在10010交易账户状态被挂起31290该客户账号已销户10011交易账户不存在31300该客户账号已挂失10012交易账户已经销户31310该客户账号已冻结10013交易账户与银行方账户未建立对应关系31320该客户账号状态错误10014交易账户与银行方账户已建立对应关系31330该客户账号有未回交割10015该客户转帐功能未开启31340该客户账号当天有委托10016客户被限制转账31350有托管股票,不可销户10018预约流水不存在31360有托管股票,客户不可修改10019预约流水信息不符31380存在购回流水,10020预约流水已取款31390未撤消指定,10021预约流水未生效31400非交易时间10024单笔资金超限31470价格输入错误10025被查询流水已经成功31500可转资金不足10026被查询流水已经失败31540修改密码失败10027被查询流水不存在33010客户银行帐号错误10028被查询流水状态未知33020市场账号错误10031市场编码错误33030对应关系状态错误10032系统交易日期不符33050交易资金错误10033此交易未开通33060新工作密钥生成失败10034不允许该操作方式33070转帐时间已过10035市场公司未签到33080市场总部未取银行明细10036市场公司已经签退33090市场总部限制转帐10037市场公司已签到33100此笔交易被手工取消10038当天有业务发生,不允许销户33110币种错10039市场公司未签退33120不支持联机开销户10041市场系统错误33140无此币种10042MAC校验失败33150客户类别错误10043通讯校验失败33160当天有业务发生不能销户10044通讯消息体格式错误33170银行系统错误10047账户姓名不符33180取银行明细失败10048资金账号与管理账号未建立对应关系33190取市场明细失败10049资金账号与管理账号已建立对应关系33200交易类别非法10050签约银行不存在14005连接市场失败33210当日已经有成功转入的相同交易14006发送请求到市场失败33220不支持该业务类别14007接受市场应答失败33230没有该客户账号对应的信息14008连接交易系统失败70000参数错误70001其他错误返回码返回信息返回码返回信息21001连接银行前置失败21101连接数据库失败21002发送数据到银行前置失败21102数据库连接中断不接受指令21003接收银行前置应答失败21103系统暂时不接受指令21004发送数据到资金管理中间件失败21104Sql语句执行失败21005接收资金管理中间件应答失败21105存储过程执行失败21006银行前置发送请求到银行失败21106等待审核21007银行前置接收银行应答失败21008银行前置返回银行应答到资金管理失败21107保证金转货款失败21009连接银行失败21108货款转保证金失败21010协议号转换失败21109原密码错误21011帐户银行类型错误21110会员号不存在21012返回应答到交易客户端,资金管理客户端失败21111修改出金审核限额失败21013协议版本错误21112登录帐号不存在21014资金管理登录密码错误21113登录密码错误21015通用错误标志(发回错误信息)21114帐号未登录21016协议解析错误21115系统未日结21017连接交易后台失败21116已有未审核资金,不允许再出金21018接收交易后台返回信息失败21019发送数据到交易后台失败第3章 具体指令格式3.1支持的交易指令3.1.1交易号编码规则交易号共5位数字,第一位标识由那方发起交易,后4位标识交易的编号流水.第一位代表意义交易号描述5市场方发起交易1银行方发起交易8资金管理客户端9客户端发起交易3.1.2市场发起交易交易号交易名称交易描述50001市场签到50002市场签退50003银行转帐签约50004银行转帐解约50005银行转市场50006市场转银行50007冲银行转市场50008冲市场转银行50009市场手续费划转此协议用在担保金三方监管模式50010市场手续费收益转结算帐户50011变更银行账户50012查询某笔交易状态50013取银行转帐明细系统对账用50014发送市场资金信息50015查客户监管银行资金余额50016查市场收益帐户资金余额50017查客户银行帐户余额50018查市场存管余额查询市场在银行的保证金、货款帐户余额50020市场结算帐户转监管帐户50021虚拟子帐户转代收代付子帐户3.1.3银行发起交易交易号交易名称交易描述10001银行转帐签约10002银行转帐解约10003修改客户资料10004变更银行账户10005银行转市场10006市场转银行暂不支持10007冲银行转市场10008冲市场转银行10009利息入金监管帐户利息划入利息结算子帐户10010查市场资金余额3.1.4资金管理客户端发起交易交易号交易名称交易描述80001设置出金超限审核金额80002执行Sql语句80003取得Sql语句查询记录80004执行存储过程80005审核出金80006资金管理客户端登录80007审核入金80008设置入金超限审核金额3.1.5客户端发起交易交易号交易名称交易描述90001登录资金管理90002查市场银行转账明细90003修改资金密码90004银行转市场90005市场转银行90006查银行资金余额3.1.6通用协议交易号交易名称交易描述70001出入金通知交易接口约定1 在接口所需的请求或应答要素中，“*”符号表示该要素为必须项，“!”表示该要素可为NULL，但是该元素一定存在，内容可以为空；2 本接口要求银行和市场对账户类交易能够支持重发机制；3 本接口要求银行和市场对转帐类交易支持冲正机制；