支付机构客户备付金存管系统接口说明3A7资料.docx
《支付机构客户备付金存管系统接口说明3A7资料.docx》由会员分享，可在线阅读，更多相关《支付机构客户备付金存管系统接口说明3A7资料.docx（52页珍藏版）》请在冰点文库上搜索。
支付机构客户备付金存管系统接口说明3A7资料
商密三级
机构端接口说明
2014年3月
1.文档属性
文档属性
内容
文档名称
中国工商银行支付机构客户备付金存管系统接口规范
文档版本号
A7
文档状态
意见征求稿
文档编写完成日期
2014-3-24
作者
章秀君
中心内部发布范围
2.文档变更历史清单
文件版本号
修正日期
修正人
备注
A1
2010-8-25
陈铁城
增加了文件格式、内容的约定，字段数据字典的说明，因本次修改不涉及文件接口的结构
A2
2011-5-3
陈铁城
增加STL05文件。
增加机构端发起支付结构备付金存管账户余额查询接口。
增加机构端发起支付结构备付金存管账户交易明细查询。
A3
2011-06-09
曹峰
文档更名
根据人行最新的管理细则对内容进行修订
A4
2011-11-16
陈铁城
增加资金调拨、手续费结转、利息结转、客户出金联机接口；增加合作银行预结手续费文件接口。
增加基金销售业务监管接口。
A7
2014-03-24
章秀君
本次修改2.5章节，将原有新人行校验机制的14个文件接口做了调整，整合成两个文件接口，文件中数据通过“数据类型”的字典项来区分人行对应报表数据。
3.本次修改变更说明
序号
变更内容简述
A1
增加了文件格式、内容的约定，字段数据字典的说明，因本次修改不涉及文件接口的结构，接口版本号仍为1.0
A7
本次修改2.5章节，将原有新人行校验机制的14个文件接口做了调整，整合成两个文件接口，文件中数据通过“数据类型”的字典项来区分人行对应报表数据。
第1章概述
本接口文档为意见征求稿，具体开发时以正式文档为准
1.1系统介绍
2010年6月21日，中国人民银行在其网站上正式公布了《非金融机构支付服务管理办法》（以下简称办法）。
《办法》明确规定了非金融机构从事支付服务市场准入条件、审批程序、业务种类；确定了支付机构在规范经营、资金安全、系统运行等方面应承担的责任与义务；明确了人民银行工作人员、商业银行、支付机构等各责任主体相应承担的法律责任。
《办法》对支付机构客户备付金的归属进行了说明，将支付机构接受客户备付金账户在银行存管，银行对存放在本机构的客户备付金的使用情况进行监督以法规的形式得以确定。
《办法》将于2010年9月1日起正式施行。
因此，我行开发了非金融机构第三方支付服务系统，并在其上提供了支付机构客户备付金存管产品。
1.2产品介绍
1、支付机构客户备付金存管产品：
我行为支付机构开立备付金专用存款账户并建立支付机构备付金存管台账，通过支付机构向我行传递备付金缴存、转移指令，我行进行合法检查后更新备付金账户和台账信息，从而实现《办法》中规定的商业银行对支付机构客户备付金账户的监督和管理。
1.3术语及约定
1、在接口描述中，Max${Length}Text表示最大长度为Length，最小长度为1的字符格式；
2、在接口描述中，{x,y}{m,n}表示取值范围为[x,y]，字段长度为[m,n]（闭区间）；
3、在接口描述中，XMLTag：
表示报文字段所处的XML节点。
所有节点的根节点为/MsgText，即完整的报文如下：
xmlversion='1.0'encoding="GBK"?
>
……
请求报文示例：
返回报文示例：
第2章接口描述
2.1范围
1、适用于非金融机构第三方支付服务系统通讯报文的设计和使用。
对于报文数据传输中的依赖的网络协议、网络规则、加密认证等不在本文档中涉及。
2.2功能定义
本文将业务划分为以下几个种类，并可进一步划分为若干个业务功能类型，通过业务功能码进行标示。
每个业务功能码对应一类输入输出报文格式。
（注：
银行发起为“Y”则表示可以由银行端主动发起的交易，机构端同）
业务种类
业务功能码
业务说明
银行发起
机构发起
涉及产品
系统类
10001
日切通知
N
Y
备付金存管
10002
备付金存管数据文件就绪通知
N
Y
备付金存管
业务查询类
21008
备付金存管账户余额查询
N
Y
备付金存管
21009
备付金存管账户明细查询
N
Y
备付金存管
业务转账类
22001
合作机构发起入金
N
Y
备付金存管
22002
合作机构发起出金
N
Y
备付金存管
22003
合作机构发起入金冲正
N
Y
备付金存管
22004
合作机构发起出金冲正
N
Y
备付金存管
21001
资金调拨
N
Y
备付金存管
21002
资金调拨冲正
N
Y
备付金存管
21003
手续费出金
N
Y
备付金存管
21004
手续费出金冲正
N
Y
备付金存管
21005
利息出金
N
Y
备付金存管
21006
利息出金冲正
N
Y
备付金存管
2.3业务功能接口详述
说明：
1、交易发起方置报文传输标志为“9”，表示交易未处理。
交易应答方收到报文并处理后，若明确有交易成功或者失败，则置该报文传输标志为“0”，表示交易已处理。
交易发起方接收到返回报文后，应首先判断报文传输标志是否为“0”，若不为“0”，则该笔交易的处理状态是“未知的”（无法确定成功、失败，应进行特殊处理）；
2、其他字段参照下文中的具体说明。
3、交易传输报文格式采用定长加数字签名形式，数字签名生成工具详见附录3.4
2.3.1系统类
2.3.1.1机构端发起日切通知、文件就绪通知
说明：
1、机构发起的日切通知交易，标识了前一个交易日结束、后一个交易日的开始。
在我行对日切通知报文进行成功返回之后，双方的所有后续交易都应采用日切后的日期来进行；
2、在机构与我行签订合作协议时，会维护一个最晚日切时间。
当每日到达该时间，并且我行并未收到来自机构端的日切通知报文时，系统会强制对该机构的工作日期进行切换；
3、机构每日清算完成，并生成备付金存管数据文件在其指定的服务器及路径之后，应发起文件就绪通知交易，通知我行获取数据文件，以进行后续的核对流程；
4、机构端生成的备付金存管数据文件包括：
客户资金账号开销户文件（STL01）、客户交收明细文件（STL02）、客户资金账号状态核对文件（STL03）、客户资金账号余额明细文件（STL04）等。
交易请求报文
发送方：
机构端
字段名称
XMLTag
格式
是否可选
备注
版本
Max30Text
否
描述当前通讯接口使用的版本号
送“1.0.0”
应用系统类型
{0,9}{1,1}
否
7：
非金融机构第三方支付服务系统
报文传输标志
{0,9}{1,1}
否
9：
交易未处理
业务功能码
{0,9}{5,5}
否
10001日切通知
10002备付金存管数据文件就绪通知
交易发起方
{A-Z}{1,1}
否
P：
支付机构端发起
支付机构代码
{0,9}{1,30}
否
校验该支付机构已在我行系统中注册
银行代码
{0,9}{8,8}
是
我行在支付机构中设定的代码
不校验该字段
交易日期
{0,9}{8,8}
否
YYYYMMDD
必须与我行系统当前工作日期相同
交易时间
{0,9}{6,6}
是
HHMMSS
不校验该字段
支付机构端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
摘要
Max30Text
是
无
合作方日期
{0,9}{8,8}
否
日切必送，必须大于当前日期。
交易应答报文：
字段名称
XMLTag
格式
是否可选
备注
版本
Max30Text
否
同输入字段
应用系统类型
{0,9}{1,1}
否
同输入字段
报文传输标志
{0,9}{1,1}
否
9：
交易未处理
0：
交易已处理
业务功能码
{0,9}{5,5}
否
同输入字段
交易发起方
{A-Z}{1,1}
否
同输入字段
支付机构代码
{0,9}{1,30}
否
同输入字段
银行代码
{0,9}{8,8}
是
同输入字段
交易日期
{0,9}{8,8}
否
同输入字段
交易时间
{0,9}{6,6}
是
同输入字段
交易运行标志
{0,9}{1,1}
否
0–交易成功
1–交易失败
返回代码
Max5Text
否
见返回代码信息说明
返回信息
Max128Text
否
见返回代码信息说明
支付机构端流水号
{0,9}{1,20}
否
同输入字段
银行流水号
{0,9}{20,20}
否
无
摘要
Max30Text
是
无
2.3.2交易类
2.3.2.1机构端发起备付金资金调拨、手续费结转
说明：
1、支付机构备付金存管账户之间的头寸调拨需通过本交易完成，同时支持贷方账户为行内和跨行的指令。
2、手续费结转指令是指结转支付机构应收会员手续费，划入支付机构自有资金账户。
2.3.2.2机构端发起利息结转
说明：
1、支付机构客户备付金存管账户产生的利息，应通过本交易结转。
利息结转分两次转帐，完成后合作方流水应加2。
即若合作方上送流水号为S申请利息结转，下一笔其他指令流水号应为S+2。
2.3.2.3机构端发起客户出金
2.3.2.4机构端发起垫资出金
（2013年9月新增垫资出金接口）
2.3.3查询类
2.3.3.1支付结构备付金存管账户余额查询
请求报文：
字段名称
XMLTAG
格式
是否可选
备注
版本
MAX30TEXT
否
描述当前通讯接口使用的版本号
送“1.0.0”
应用系统类型
{0,9}{1,1}
否
7：
非金融机构第三方支付服务系统
报文传输标志
{0,9}{1,1}
否
9：
交易未处理
业务功能码
{0,9}{5,5}
否
21008：
查询支付机构备付金存管账户余额
交易发起方
{A-Z}{1,1}
否
P：
支付机构端发起
支付机构代码
{0,9}{1,30}
否
校验该支付机构已在我行系统中注册
支付机构端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
银行代码
{0,9}{8,8}
是
我行在支付机构中设定的代码
不校验该字段
交易日期
{0,9}{8,8}
否
YYYYMMDD
必须与我行系统当前工作日期相同
交易时间
{0,9}{6,6}
是
HHMMSS
不校验该字段
支付机构备付金存管账号
{0,9}{1,17}
否
已在我行系统中注册
摘要
MAX30TEXT
是
无
应答报文：
字段名称
XMLTAG
格式
是否可选
备注
版本
MAX30TEXT
否
同输入字段
应用系统类型
{0,9}{1,1}
否
同输入字段
报文传输标志
{0,9}{1,1}
否
9：
交易未处理
0：
交易已处理
业务功能码
{0,9}{5,5}
否
同输入字段
交易发起方
{A-Z}{1,1}
否
同输入字段
支付机构代码
{0,9}{1,30}
否
同输入字段
支付机构端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
银行代码
{0,9}{8,8}
是
同输入字段
银行端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
交易日期
{0,9}{8,8}
否
YYYYMMDD
必须与我行系统当前工作日期相同
交易时间
{0,9}{6,6}
是
HHMMSS
不校验该字段
交易运行标志
{0,9}{1,1}
否
0–交易成功
1–交易失败
返回代码
MAX5TEXT
否
见附录返回代码信息说明
返回信息
MAX128TEXT
否
见附录返回代码信息说明
支付机构备付金存管账号
{0,9}{1,17}
否
同输入字段
备付金存管账户余额
{0,9}{1,17}
否
以分为单位，最大程度17位整数
摘要
MAX30TEXT
是
无
2.3.3.2支付机构管理账户分类标志余额查询
请求报文：
字段名称
XMLTAG
格式
是否可选
备注
版本
MAX30TEXT
否
描述当前通讯接口使用的版本号
送“1.0.0”
应用系统类型
{0,9}{1,1}
否
7：
非金融机构第三方支付服务系统
报文传输标志
{0,9}{1,1}
否
9：
交易未处理
业务功能码
{0,9}{5,5}
否
21011：
支付机构管理账户分类标志余额查询
交易发起方
{A-Z}{1,1}
否
P：
支付机构端发起
支付机构代码
{0,9}{1,30}
否
校验该支付机构已在我行系统中注册
支付机构端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
银行代码
{0,9}{8,8}
是
我行在支付机构中设定的代码
不校验该字段
交易日期
{0,9}{8,8}
否
YYYYMMDD
必须与我行系统当前工作日期相同
交易时间
{0,9}{6,6}
是
HHMMSS
不校验该字段
分类标志1
{0,9}{3,3}
是
001-999
分类标志2
{0,9}{3,3}
是
001-999
分类标志3
{0,9}{3,3}
是
001-999
币种
{A-Z}{3,3}
否
RMB、HKD、USD
应答报文：
字段名称
XMLTAG
格式
是否可选
备注
版本
MAX30TEXT
否
同输入字段
应用系统类型
{0,9}{1,1}
否
同输入字段
报文传输标志
{0,9}{1,1}
否
9：
交易未处理
0：
交易已处理
业务功能码
{0,9}{5,5}
否
同输入字段
交易发起方
{A-Z}{1,1}
否
同输入字段
支付机构代码
{0,9}{1,30}
否
同输入字段
支付机构端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
银行代码
{0,9}{8,8}
是
同输入字段
银行端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
交易日期
{0,9}{8,8}
否
YYYYMMDD
必须与我行系统当前工作日期相同
交易时间
{0,9}{6,6}
是
HHMMSS
不校验该字段
交易运行标志
{0,9}{1,1}
否
0–交易成功
1–交易失败
返回代码
MAX5TEXT
否
见附录返回代码信息说明
返回信息
MAX128TEXT
否
见附录返回代码信息说明
管理账户余额
{0,9}{1,17}
否
以分为单位，最大程度17位整数
2.3.3.3支付结构备付金存管账户交易明细查询
请求报文：
字段名称
XMLTAG
格式
是否可选
备注
版本
MAX30TEXT
否
描述当前通讯接口使用的版本号
送“1.0.0”
应用系统类型
{0,9}{1,1}
否
7：
非金融机构第三方支付服务系统
报文传输标志
{0,9}{1,1}
否
9：
交易未处理
业务功能码
{0,9}{5,5}
否
21009：
支付结构备付金存管账户交易明细查询
交易发起方
{A-Z}{1,1}
否
P：
支付机构端发起
支付机构代码
{0,9}{1,30}
否
校验该支付机构已在我行系统中注册
支付机构端流水号
{0,9}{1,20}
否
至少每个工作日内不重复
银行代码
{0,9}{8,8}
是
我行在支付机构中设定的代码
不校验该字段
交易日期
{0,9}{8,8}
否
YYYYMMDD
必须与我行系统当前工作日期相同
交易时间
{0,9}{6,6}
是
HHMMSS
不校验该字段
支付机构备付金存管账号
{0,9}{1,17}
否
已在我行系统中注册
查询标志
{0,9}{1,1}
否
1：
第一次查询
2：
上一页
3：
下一页
每次查询记录数
{0,9}{1,3}
否
最大长度3位整数，输入5，目前仅支持每次返回5条
记录顺序号
{0,9}{1,11}
是
首次查询时不输；
当有下页时，翻下页上送当前页最后一条记录顺序号；
当有上页时，翻上页上送上页第一条记录顺序号；
起始入账日期
{0,9}{8,8}
否
YYYYMMDD
19000101到99991231之间
截止入账日期
升级会员 