资金清算系统接口V12.doc

兴业信用卡资金清算相关接口 修订记录 1 1 资金清算系统报文结构 3 2.1 报文分类 3 2.2 报文的解析与传输 3 2.2.1 报文解析 3 2.2.2 SOCKET报文传输 4 2.2.3 SOCKET报文样例 4 2 与信货接口 5 2.1 批量文件交互 5 2.1.1 自扣接口 5 2.1.2 放款接口 8 2.2 批量文件通知报文 10 2.3 实时交互方式 11 2.3.1 自扣接口 11 2.3.2 放款接口 12 2.3.3 冲正接口 13 2.3.4 放款查询接口 13 2.3.5 签约验证接口 14 2.3.6 签约关系查询接口 15 1. 附件 16 修订记录 修订时间 修订人 修订内容 2014-12-16 彭利田 初稿 2015-01-14 郑小磊 1、批量文件接口 将借记卡号改为客户账号 2、同名验证接口 返回报文增加account（客户帐号）字段 2015-03-03 郑小磊 1、实时扣款请求报文增加bank_code(银行编码) 2、实时放款请求报文增加bank_code(银行编码) 3、同名校验请求报文增加bank_code(银行编码) 资金清算系统报文结构 资金清算系统报文统一采用xml格式。所有的报文均以root作为根元素，每个root元素中只有一个message元素。message元素中包含代表具体的业务的元素。每个业务元素由一系列属性元素构成，不同的业务元素中包含的属性元素有所不同。 作为约定，root元素、message元素与业务元素均是小写字母的形式。 以放款请求报文为例，报文的格式如下： 在下文中出现的具体报文格式描述中，“出现要求”列包含的值的含义如下表所示： 符号 含义 请求方约束 服务方约束 R Required(必须的) 必须包含该域 必须校验该域是否存在和内容的合法性 C Conditional(有条件的) 如果条件符合必须包含该域 当条件满足时，必须校验该域是否存在 当该域存在时，必须检查其内容的合法性 O Optional(可选的) 该域可选 当该域存在时，必须检查其内容的合法性 报文分类 资金清算系统中的报文按照交互模式的不同，分为以下几类 服务请求类报文 服务请求类报文用于请求-应答交互模式，由服务使用者向服务提供者发送。 服务应答类报文 服务应答类报文用于请求-应答交互模式，由服务提供者向服务使用者返回。 通知类报文 通知类报文用于单向通知交互模式，由通知发送者向通知接收者发送。 报文的解析与传输 报文解析 对XML解析的基本要求如下 版本号检查 用于表示组件支持的协议版本号。消息版本号必须表示为：n+.n+[.n+] ，其中 “n” 表示数字，?“+”表示一个或多个。比如1.0或1.1.0。在所有的消息中，各组件都必须填写自身支持的协议版本号。消息版本号不能低于1.1.0。如果消息版本号低于接收方组件支持的最低版本号，则接收方组件必须返回Error消息，并且设置错误码=0006。 xml解析 为了可以支持后续协议版本，xml解析的实现不要做严格的验证。特别是需要忽略未被确认的域。所有xml消息必须用“GBK”编码。 SOCKET报文传输 在SOCKET请求/响应体中包含XML形式的报文。对SOCKET传输的基本要求如下： 使用TCP发送消息 消息请求基于TCP/IP协议方式。 SOCKET消息头要求 SOCKET请求与响应消息中必须按照如下要求设置： 一个报文必须包含两个部份（报文长度+报文体） 其中: 报文长度=报文体长度，MAC值包含在报文体内xml节点内 报文长度为一个4位长度的值。 报文最大长度不能超过9999 报文编码格式为：GBK SOCKET报文样例 报文样例(取冲正为例) 0244root message version1.1.0/version instidLOAN/instid transcode2001/transcode serialno2013031300000001/serialno dat10:17:06/date oldserialno2013031300000006/oldserialno /message /root 与信货接口 批量文件交互 采用FTP方式，服务器之间通过文件服务器进行文件交互。 自扣接口 自扣文件 批量接口名称 自扣文件 文件命名规范 0309- AUOREP-XXXX-YYYYMMDD (YYYYMMDD