大宗商品电子交易市场银行接口转账协议规范.docx
- 文档编号:1676020
- 上传时间:2022-10-23
- 格式:DOCX
- 页数:22
- 大小:23.47KB
大宗商品电子交易市场银行接口转账协议规范.docx
《大宗商品电子交易市场银行接口转账协议规范.docx》由会员分享,可在线阅读,更多相关《大宗商品电子交易市场银行接口转账协议规范.docx(22页珍藏版)》请在冰豆网上搜索。
大宗商品电子交易市场银行接口转账协议规范
大宗商品电子交易市场银行接口转账协议规范
提供给专研行业技术发展和交易市场的技术部内部人员参考之用。
文件状态:
[√]草稿
[ ]正式发布
[ ]正在修改
文件标识:
银行转帐协议规范
当前版本:
V2.0
作 者:
黄东
完成日期:
2008-08-15
版本号
*变化
状态
简要说明
日期
变更人
审核日期
审核人
V2.0
M
协议修订
2008-08-15
黄东
V2.1
A
协议修订,增加对金额处理的说明。
即发送方金额*100,接收方金额除以100,使金额不出现小数位。
加入帐户图。
增加大数据量文件格式定义。
2008-10-14
蒋加君
V2.2
M
50010增加“收益类型”字段
2008-10-28
蒋加君
V2.3
M
50003,50004,50011增加
“开户银行”字段
2008-10-31
V2.4
M
50015增加“查询日期”字段
2008-11-3
V2.5
M
修改20020,10009。
删除20016,20022。
增加交易说明,帐户结构说明。
2008-12-9
*变化状态:
A——增加,M——修改,D——删除
第一章 通讯协议格式
1.1、通讯方式。
从Client到通信服务器的通信在底层符合TCP/IP协议规范,其应用协议是针对转帐特点而设计的。
双方通信采用异步通信方式,采用短连接方式,双方均可发起指令,当一方发起指令后在处理完毕后会主动断开。
通信工具采用MTI(Transaction MiddlewareSystem)提供的包传输协议,每一段数据组成一个数据包,各段数据采用各个数据包同时连续发送的方法实现。
1.2、协议规范
在本协议中无论字符,数字全部采用字符串方式传送。
为避免金额出现小数,所有金额在发送时都乘以100后发送,接收方除以100后进行处理。
如转帐资金为1000.23元,数据传输时即为‘100023’,不采用二进制或其它格式存放数据。
包头中各字段顺序固定,对于有长度要求的,长度不够时采用右补空格填充,如‘100002A ’。
包体中对数据长度不做具体要求,有具体的分割符号来区分。
1.3、协议包格式约定
1.3.1包头结构定义
MtiHead=Packed RECORD
HeadType:
Array[0..4] of CHAR; //数据帧类型
SubType:
Array[0..1] of CHAR; //子数据帧类型
HeadVer:
Array[0..1] of CHAR; //协议版本号 目前版本必须为字符’20’
ReqMac:
Array[0..11] of CHAR; //请求方MAC地址
ReqID:
Array[0..19] of CHAR; //请求方标识,应答时原样返回
DataLen:
Array[0..4] of CHAR; //数据帧长度
NextFlag:
Array[0..0] of CHAR; //是否有下一包数据N没有,Y有
EncFlag:
Array[0..0] of CHAR; //加密标志Y加密N不加密
BankID:
Array[0..2] of CHAR; //银行代码
RtnNO:
ARRAY[0..4]of CHAR; //返回码‘00000’为成功,其他为失败
DataCol:
ARRAY[0..0]of BYTE; //包体数据字段列数没有数据返回时填0x00
DataRow:
Array[0..3] of CHAR; //包体数据行数没有数据返回时填‘0000’
ExWaterID:
Array[0..13] of CHAR; //流水号 系统唯一流水号
CommInfo:
ARRAY[0..19] of CHAR; //保留信息 CommInfo[0]=’1’资金管理客户端
//CommInfo[0]=’2’交易客户端
CheckNum:
ARRAY[0..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
协议版本号 目前版本必须为字符’20’
ReqMac
请求方MAC地址
ReqID
请求方标识,应答时原样返回
DataLen
数据帧长度
NextFlag
是否有下一包数据N没有,Y有
EncFlag
加密标志0x01加密0x00不加密
BankID
银行代码
RtnNO
返回码
DataCol
包体数据字段列数
DataRow
包体数据行数
ExWaterID
流水号
CommInfo
保留信息
CheckNum
校验和
包体
DataPack
USERID<#>CHANGEMONEY<#>INOUTTYPE<#>
0001<#>3005.23<#>1<#>
0002<#>3005.23<#>1<#>
0003<#>3005.23<#>1<#>
1.3.2包体结构定义
包体结果说明:
1.包体全部内容均为字符串。
2.<#>为各元素之单的分割符,表示一个ACSCII1的字符。
<#>目前定义为0x08
3.每个元素的顺序可以任意改变,如某元素信息不存在,表示为空值,但列名必须存在。
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行:
...... <#>
举例如下:
请求:
CustTradeID<#>ChangeMoney<#>MoneySty<#>Memo<#>
0001<#>3005.23<#>1<#><#>
0002<#>3005.23<#>1<#>10052<#>
0003<#>3005.23<#>1<#><#>
应答(错误):
RtnNo<#>RtnInfo<#>
10001<#>资金密码校验失败<#>
应答(正确有返回数据):
CustTradeID<#>ChangeMoney<#>MoneySty<#>Memo<#>
0001<#>3005.23<#>1<#><#>
应答(正确无返回数据):
1.3.3银行具体帐户结构图
市场人民币总帐户
交易商资金子帐户
交易商1
交易商N
交易资金子帐户
担保金子帐户
交易资金子帐户
担保金子帐户
手续费子帐户
代收代付子帐户
交易市场收益子帐户
利息结算子帐户
市场结算帐户
1.市场人民币总帐户:
市场在银行开设的资金监管帐户。
下设“交易商资金子帐户”“交易市场收益子帐”虚拟帐户。
交易商资金子帐户:
为各交易商所有资金总和。
交易市场收益子帐:
市场的所有收益总和。
市场可已将此帐户中资金划转到“市场结算帐户”。
其中包括手续费子帐户,代收代付子帐户,利息结算子帐户。
2.市场结算帐户:
市场在银行开设的非监管帐户,此帐户资金市场可以自由划转。
1.3.4系统结构图
第2章 元素列表定义
2.1元素约定
接口中元素名不区分大小写
2.2元素列表
元素名
元素含义
字符
说明
HeadType
数据帧类型
C5
定长为五位数字,1和2开头代表银行发起,5,6代表市场发起
SubType
子数据帧类型
C2
ReqID
请求方标识
C20
用于标记请求时的流水号,在应答时直接原样返回
HeadVer
协议版本号
C2
协议版本号 目前版本必须为20
ReqMac
请求方MAC地址
C12
DataLen
数据帧长度
C5
不包括包头数据长度
NextFlag
是否有下一包数据
C1
N没有,Y有
EncFlag
加密标志
C1
Y加密N不加密
DataCol
包体数据字段列数
C1
DataRow
包体数据行数
C4
ExWaterID
流水号
C14
系统唯一标识
DelWaterID
被冲正流水号
C14
用于冲正,被冲正交易的流水号
RtnNo
返回码
C5
RtnInfo
返回信息
C50
CommInfo
保留信息
C20
CheckNum
校验和
C5
PinKey
主密钥
C20
MacKey
MAC密钥
C20
BankID
银行编号
C3
001浦发行
002工行
003招行
004农行
005建行
006交行
007广发行
008中国银行
009商行
BankIDIn
转入银行编号
C3
BankSubNo
银行分行号
C10
BankName
银行名称
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 大宗 商品 电子 交易市场 银行 接口 转账 协议 规范