平安银行银银平台接口规范-三方存管

程序规格说明书V2.0

平安银行银银合作平台系统

设计规格说明书-三方存管接口

平安银行信息科技部

2010年03月23日

第 1 页共29页

设计规格说明书--三方存管文档修改记录

第 2 页共29页

设计规格说明书--三方存管

第 3 页 共 29页

版本

日期

说明 编写者 审核者 1.0.0.1 2011-3-12 创建 邓远强 1.0.0.2 2011-3-23 初稿

章黎明 1.0.0.3 2011-3-28 修订格式，校验 陈树艺 1.0.0.4 2011-9-9

删了两个对账交易,将交易和文件格式进行了分类;修改了交易列表说明

章黎明

邓远强

1.0.0.5 2011-12-19

修改日终资金对账格式说明

邓永优

1.0.0．6 2012-02-17

增加“存管银行预指定撤销[存管系统发起]908022”交易

虞冬明

1.0.0.7 2012-6-14

存管银行预指定

确认增加“经办人”、“经办人证件类型”、“经办人证件号码”三个输入域 注意：为了兼容已已上线合作行，此三个数据域可不上送，银银平台做适配处理

虞冬明

1.0.0．8 2012-12-21

修改908022不需

王健

设计规格说明书--三方存管

第 4 页 共 29页 要MAC 校验

1.0.17 2013-3-30 908001交易accManger

字段改为可

空

李裕雄

1.0.18 20130607 增加908020和908023交

易 叶威

1.0.19 2013-9-5 按业务要求对文档进行

修改 叶威

1.0.19 2013-9-6 修改文档，添加资金密码

加密说明 叶威

1.0.20 2014-3-27 新增日终账户销户对账

文件格式 虞冬明

1.0.21 2014-07-15 新增一步式签约交易 叶威

1.0.22 20140801 取消获取券商列表信息文件，

增加客户结算

余额查询 叶威

设计规格说明书--三方存管

目录

文档修改记录 (2)

目录 (5)

总体说明 (7)

1通讯规则 (8)

2交易列表 (8)

3公共交易接口 (10)

3.1资金划转[900007] (10)

3.2签到/签退[900015] (10)

3.3对账通知[900017] (10)

3.4资金冲正[900023] (10)

3.5批量提交通知[900026] (10)

3.6交易流水状态查询[900029] (10)

4存管交易接口 (10)

4.1公共报文头 (10)

4.2存管银行预指定确定908001 (11)

4.3签约账户变更908003 (13)

4.4银行转证劵908004 (15)

4.5证劵转银行908005 (16)

第 5 页共29页

设计规格说明书--三方存管4.6查询客户证劵资金余额908006 (18)

4.7交易明细查询908008 (20)

4.8查询客户存管签约信息908020 (22)

4.9存管银行预指定撤销[银银平台发起]908022 (23)

5对账文件格式 (24)

5.1券商列表信息文件格式 ...............................................................................错误!未定义书签。

5.2日终资金对账文件 (26)

5.3日终账户对账文件 (27)

第 6 页共29页

设计规格说明书--三方存管

总体说明

本部分接口为银银平台代理三方存管业务所用，是银银平台和合作行之间的接口。本交易接口适用范围：合作行柜面。

本文档阅读对象：技术人员。

第7 页共29页

设计规格说明书--三方存管

第 8 页 共 29页 1 通讯规则

参考《平安银行银银平台接口规范-公共交易》.

********************************************************************* 特别说明：券商证券资金密码采用ANSI9.8不带账号DES 加密。

明文长度要求4-12位，组合成16位16进制字符串PIN

PIN 格式：

BYTE 1 PIN 的长度

BYTE 2 – BYTE 3/4/5/6/7 4--12个PIN

BYTE 4/5/6/7/8 – BYTE 8 填充 “F ”

因为是不带账号加密，所以用PIN 与“0000000000000000”进行异或，得到了PINBLOCK ，也就是PIN 本身（也可省掉PIN 与“0000000000000000”的异或），最后将PINBLOCK 和密钥进行DES 加密运算（模式为“DES/ECB/NoPadding ”），得到最终的密文。

例如：资金密码明文是“123456”，长度为6位。

组合PIN 为“06123456FFFFFFFF ”。

“06”是代表明文的长度，“123456”是明文本身，“FFFFFFFF ”是填充字符； 然后将“06123456FFFFFFFF ”与我们提供的密钥进行DES 加密运算得到最终的证券资金密码（因为PIN 与“0000000000000000”进行异或还是PIN 本身所以例子省掉了该过程）。

********************************************************************* 2 交易列表

序号 分类 交易代码 交易名称 发起方 是否需

要MAC

校验 备注

1.

公 共

交 900015 签到/签退 合作行柜面 需要 “公共交易”

和“基

2. 900007 资金划转 银银平台 需要

设计规格说明书--三方存管

第 9 页 共 29页

3. 易 900023 资金冲正 银银平台 需要 本交易”合作行必须实现，为合作行开展代理平安银行业务产品的前提。

4. 900017 对账通知 银银平台 需要

5. 900029 交易状态查询 银银平台

不需要

6.

基 本 交

易

908001

存管银行预指定确定

合作行柜面 需要

7. 908003 签约账户变更 合作行柜面 需要

8. 扩 展 交 易

908004 银行转证劵 合作行柜面 需要 监管要求暂时不在银行端实现 9.

908005

证劵转银行

合作行柜面 需要

10. 可 选 交 易

908006

查询客户证劵资金余额 合作行柜面 不需要

可选

11. 900026 批量提交通知

银银平台 需要 可选

12. 908020

查询客户存管签约信息

合作行柜面 不需要 可选

13. 908022

存管银行预指定确认撤销

银银平台 不需要

若合作行保存客户信息，该交易必选 14.

900013

查询客户结算余额

银银平台 不需要

可选

15. 908026 存管一步式签约

银银平台 需要 可选

16.

908008 查询交易明细

合作行柜面 不需要

可选

设计规格说明书--三方存管

3公共交易接口

3.1资金划转[900007]

具体接口参考《平安银行银银平台接口规范-公共交易》900007接口

3.2签到/签退[900015]

具体接口参考《平安银行银银平台接口规范-公共交易》900015接口

3.3对账通知[900017]

具体接口参考《平安银行银银平台接口规范-公共交易》900017接口

3.4资金冲正[900023]

具体接口参考《平安银行银银平台接口规范-公共交易》900023接口

3.5查询客户结算余额[900013]

具体接口参考《平安银行银银平台接口规范-公共交易》900013接口

3.6交易流水状态查询[900029]

具体接口参考《平安银行银银平台接口规范-公共交易》900029接口

4存管交易接口

4.1公共报文头

请求报文头和应答报文头一致。

请参考《平安银行银银平台接口规范-公共交易.doc》

特别说明：存管业务在报文头中的服务代码送0802。

第10 页共29页

设计规格说明书--三方存管

第 11 页 共 29页

4.2 存管银行预指定确定908001

【输入】 序

中文名称 xmltag 字段类型 属性 备注 报文头

1. 银行账号 accno V ARCHAR2(32) [1..1]

2. 客户名称 chinesename V ARCHAR2(70) [1..1]

3. 证件类型 certtype V ARCHAR2(2) [1..1]

4. 证件号码 certno V ARCHAR2(32) [1..1]

5. 邮政编码 Post V ARCHAR2(6)

[0..1]

6. 联系地址 Addr V ARCHAR2(128) [0..1]

7. 电子邮件地址 email V ARCHAR2(60) [0..1]

8. 联系电话 phone V ARCHAR2(16) [0..1]

9. 移动电话 mobile V ARCHAR2(11) [0..1] 10. 传真 Fax V ARCHAR2(16) [0..1] 11. 券商代码 seccode

V ARCHAR2(8)

[1..1] 12.

证券资金台账

号

capitalaccount V ARCHAR2(22)

[1..1]

13.

券商证券资金

密码

capitalpwd

V ARCHAR2(16)

[1..1]

ANSI9.8不带

账号DES

加

设计规格说明书--三方存管

第12 页共29页密

14.

币种currencyabbr V ARCHAR2(3) [1..1] RMB－人民

币

HKD－港币

USD－美元

默认“RMB”

15.

客户类型customertype V ARCHAR2(2) [1..1] 00：机构（法

人），01：

个人

16.

开户机构openaccorg V ARCHAR2(10) [1..1] 4位合作行号

17.

备注memo V ARCHAR2(40) [0..1]

18.

客户经理号accManger varcahr2(8)[0..1]

19.

经办人姓名TrnName VARCHAR2(20) [0..1] 机构必输

20.

经办人证件类

型

TrnIdType VARCHAR2(2) [0..1] 机构必输

21.

经办人证件号

码

TrnIdCode VARCHAR2(18) [0..1] 机构必输

【输出】

序号中文名称xmltag 字段类型属性备注报文头

1 银行账号accno V ARCHAR2(32) [1..1]

设计规格说明书--三方存管

第 13 页 共 29页

2 客户名称 chinesename V ARCHAR2(70) [1..1]

3 证件类型 certtype V ARCHAR2(2) [1..1]

4 证件号码 certno V ARCHAR2(32) [1..1]

5 券商名称 seqname V ARCHAR2(120) [1..1]

6

币种

currencyabbr

V ARCHAR2(3)

[1..1]

RMB －人民

币 HKD －港币 USD －美元 默认'RMB'

7 证券资金账号 capitalaccount V ARCHAR2(22) [1..1] 8

备注

memo

V ARCHAR2(40)

[0..1]

4.3 签约账户变更908003

【输入】 序号 中文名称 xmltag 数据类型 属性 备注 报文头

1 券商代码 seccode V ARCHAR2(8) [1..1]

2 证券资金台账号 capitalaccount V ARCHAR2(22) [1..1]

3

券商证券资金密

码

capitalpwd

V ARCHAR2(16)

[1..1]

ANSI9.8不带

账号DES 加密

设计规格说明书--三方存管

4 客户名称chinesename V ARCHAR2(70) [1..1]

5 证件类型certtype V ARCHAR2(2) [1..1]

6 证件号码certno V ARCHAR2(32) [1..1]

7 旧银行账号oaccno V ARCHAR2(32) [1..1]

8 新银行账号naccno V ARCHAR2(32) [1..1]

9 币种currencyabbr V ARCHAR2(3) [1..1] RMB－人民币

HKD－港币

USD－美元

默认'RMB'

10 客户类型customertype V ARCHAR2(2) [1..1] 00：机构（法

人），01：

个人

11 备注memo V ARCHAR2(40) [0..1]

【输出】

序号中文名称xmltag 数据类型属性备注报文头

1 券商代码seccode V ARCHAR2(8) [1..1]

2 证券资金台账号capitalaccount V ARCHAR2(22) [1..1]

第14 页共29页

设计规格说明书--三方存管

3 客户名称chinesename V ARCHAR2(70) [1..1]

4 旧银行账号oaccno V ARCHAR2(32) [1..1]

5 新银行账号naccno V ARCHAR2(32) [1..1]

4.4银行转证劵908004

【输入】

序号中文名称xmltag 数据类型属性备注报文头

1 银行账号accno V ARCHAR2(32) [1..1]

2 券商代码seccode V ARCHAR2(8) [1..1]

3 证券资金账号capitalaccount V ARCHAR2(22) [1..1]

4 客户类型customertype V ARCHAR2(2) [1..1] 00：机构（法

人），01：

个人

5 币种currencyabbr V ARCHAR2(3) [1..1] RMB－人民

币

HKD－港币

USD－美元

默认“RMB”

6 金额amount V ARCHAR(15) [1..1] 实际金额

*100。不

带小数

第15 页共29页

设计规格说明书--三方存管

第16 页共29页点

【输出】

序号中文名称xmltag 数据类型属性备注报文头

1 银行账号accno V ARCHAR2(32) [1..1]

2 客户名称chinesename V ARCHAR2(70) [1..1]

3 币种currencyabbr V ARCHAR2(3) [1..1] RMB－人民币

HKD－港币

USD－美元

默认'RMB'

4 金额amount V ARCHAR(15) [1..1] 金额*100不带

小数点

5 券商名称seqname V ARCHAR2(70) [1..1]

6 券商代码seccode V ARCHAR2(8) [1..1]

7 证券资金台账号capitalaccount V ARCHAR2(22) [1..1]

8 流水号serialno V ARCHAR2(20) [1..1] 存管流水号

4.5证劵转银行908005

【输入】

序号中文名称xmltag 数据类型属性备注

设计规格说明书--三方存管报文头

1 银行账号accno V ARCHAR2(32) [1..1]

2 券商代码seccode V ARCHAR2(8) [1..1]

3 证券资金台账号capitalaccount V ARCHAR2(22) [1..1]

4 券商证券资金密码capitalpwd V ARCHAR2(16) [1..1] ANSI9.8不

带账号

DES加

密

5 客户类型customertype V ARCHAR2(2) [1..1] 00：机构（法

人），

01：个

人

6 币种currencyabbr V ARCHAR2(3) [1..1] RMB－人民

币

HKD－港币

USD－美元

默认“RMB”

7 金额amount V ARCHAR(15) [1..1] 金额*100不

带小数

点

8 券商预约号bookno V ARCHAR2(12) [0..1]

第17 页共29页

设计规格说明书--三方存管【输出】

序中文名称xmltag 数据类型属性备注报文头

1 银行账号accno V ARCHAR2(32) [1..1]

2 客户名称chinesename V ARCHAR2(70) [1..1]

3 币种currencyabbr V ARCHAR2(3) [1..1] RMB－人民币

HKD－港币

USD－美元

默认'RMB'

4 金额amount V ARCHAR(15) [1..1] 金额*100不带小

数点

5 券商名称seqname V ARCHAR2(70) [1..1]

6 券商代码seccode V ARCHAR2(8) [1..1]

7 证券资金台账号capitalaccount V ARCHAR2(22) [1..1]

8 流水号serialno V ARCHAR2(20) [1..1] 存管流水号

4.6查询客户证劵资金余额908006

【输入】

序号中文名称xmltag 数据类型属性备注报文头

1 券商代码seccode V ARCHAR2(8) [1..1]

第18 页共29页

设计规格说明书--三方存管

第 19 页 共 29页

2 证券资金台账号 capitalaccount V ARCHAR2(22) [1..1]

3

券商证券资金密

码

capitalpwd

V ARCHAR2(16)

[1..1]

ANSI9.8不带

账号DES 加密

4

客户类型

customertype

V ARCHAR2(2)

[1..1]

00：机构（法

人），01：个人

【输出】 序号 中文名称 xmltag 数据类型 属性 备注 报文头

1 查询日期 queryDate V ARCHAR2(8) [1..1]

2 银行账号 accno V ARCHAR2(32) [1..1]

3 客户姓名 chinesename V ARCHAR2(70) [1..1]

4 券商代码 seccode V ARCHAR2(8) [1..1] 5

证券资金台账

号

capitalaccount

V ARCHAR2(22)

[1..1]

6

人民币可用余

额

RMBCurBal

V ARCHAR(15)

[1..1]

券商端证券资金

余额（中信证券不支持该余额查询，直接返回0）

设计规格说明书--三方存管

第 20 页 共 29页

7

人民币可提余

额

RMBAvailBal

V ARCHAR(15)

[1..1]

券商端证券资金

余额 8

人民币管理账

号余额

RMBTruBal

V ARCHAR(15)

[1..1]

银行端证券资金

余额

9 美元可用余额 USDCurBal V ARCHAR(15) [1..1] 10 美元可提余额 USDAvailBal V ARCHAR(15) [1..1] 11

美元管理账号

余额

USDTruBal

V ARCHAR(15)

[1..1]

12 港币可用余额 HKDCurBal V ARCHAR(15) [1..1] 13 港币可提余额 HKDAvailBal V ARCHAR(15) [1..1] 14

港币管理账号

余额

HKDTruBal

V ARCHAR(15)

[1..1]

4.7 交易明细查询908008

【输入】 序号 中文名称 xmltag 数据类型 属性 备注 报文头

1 券商代码 seccode V ARCHAR2(8) [1..1] 2

证券资金台

账号

capitalaccount

V ARCHAR2(22)

[1..1]

3

起始日期

startdate

V ARCHAR2(8)

[1..1]

设计规格说明书--三方存管

第 21 页 共 29页

4 终止日期 enddate V ARCHAR2(8) [1..1]

5

包序号

querycount

V ARCHAR2(2)

[1..1]

一个包返回10条记

录（需从0开始）

【输出】 序中文名称 xmltag 数据类型 长度 说明 报文头

1 客户名称 chinesename V ARCHAR2(70) [1..1]

2 券商代码 seccode V ARCHAR2(8) [1..1] 3

证券资金台账

号

capitalaccount

V ARCHAR2(22)

[1..1]

4 结束标志 EndFlag V ARCHAR2(1) [1..1] N 未结束，Y 结束

5 返回条数 Num V ARCHAR2(2) [1..1]

6 银行账号 accno V ARCHAR2(32) [1..N] 本部分根据返回

条数循环。

7 币种 currencyabbr V ARCHAR2(3) [1..N] 8 交易金额 tranamount V ARCHAR(15) [1..N] 9 交易日期 trandate V ARCHAR2(8) [1..N] 10 交易类型 transtype V ARCHAR2(20) [1..N] 11

交易渠道

tranchannel

V ARCHAR2(20)

[1..N]

本文来源：https://www.bwwdw.com/article/oo4e.html