资金清算系统接口V.docVIP

兴业信用卡资金清算相关接口 TOC \o 1-5 \h \z 修订记录 1 HYPERLINK \l bookmark1 \o Current Document \h 1资金清算系统报文结构 3 报文分类 3 HYPERLINK \l bookmark2 \o Current Document \h 报文的解析与传输 3 报文解析 3 SOCKET 报文传输 4 SOCKET 报文样例 4 2与信货接口 5 批量文件交互 5 自扣接口 5 放款接口 7 HYPERLINK \l bookmark5 \o Current Document \h 批量文件通知报文 9 实时交互方式 10 2. 3.1 自扣接口 1() 放款接口 11 冲正接口 11 放款查询接口 12 2. 3.5 签约验证接口 13 2.3.6 签约关系查询接口 错误！未定义书签。 1.附件 14 修订记录 修订时间1 修订人 1 修订内容 2014-12-16 彭利田 初稿 2015- 01-14 郑小磊 1、批量文件接口将借记卡号改为客户账号 2、同名验证接口返回报文增加account （客户帐号）字段 2015-03-03 郑小磊 1、实时扣款请求报文增加bank code（银行编码） 2、实时放款请求报文增加bank code（银行编码） 3、同名校验请求报文增加bank code（银行编码） 1 资金清算系统报文结构 资金清算系统报文统一采用xnh格式。所有的报文均以root作为根元素，每个root 元素中只有一个nessage元素。rressage元素中包含代表具体的业务的元素。每个业务元素 由一系列属性元素构成，不同的业务元素中包含的属性元素有所不同。 作为约定，root元素、nwssage元素与业务元素均是小写字母的形式。 以放款请求报文为例，报文的格式如下： 在下文中出现的具体报文格式描述中,出现要求列包含的值的含义如下表所示： 符号 含义 请求方约束 服务方约束 R Requi r ed（必须 的） 必须包含该域 必须校验该域是否存在和 内容的合法性 C Condi t i onal （有 条件的） 如果条件符合必须 包含该域 当条件满足时，必须 校验该域是否存在 当该域存在时，必须 检查其内容的合法性 0 Cpti onal （可选 的） 该域可选 当该域存在时，必须检查 其内容的合法性 2.1报文分类 资金清算系统中的报文按照交互模式的不同，分为以下几类 服务请求类报文 服务请求类报文用于请求-应答交互模式，甶服务使用者向服务提供者发送。 服务应答类报文 服务应答类报文用于请求-应答交互模式，甶服务提供者向服务使用者返回。 通知类报文 通知类报文用于单向通知交互模式，由通知发送者向通知接收者发送。 2.2报文的解析与传输 2. 2.1报文解析 对XM.解析的基本要求如下 版本号检查 用于表示组件支持的协议版本号。消息版本号必须表示为：n+.n+[.n+]，其中 n表示数字，+表示一个或多个。比如1. 0或1.1.0。在所有的消息中，各 组件都必须填写自身支持的协议版本号。消息版本号不能低于1.1.0。如果消息版本号低于 接收方组件支持的最低版本号，则接收方组件必须返回Error消息，并且设置错误码=0006。 ■ xnti解析 为了可以支持后续协议版本，xnh解析的实现不要做严格的验证。特别是需要忽略未被 确认的域。所有xnti消息必须用GBK编码， 2.2.2 SOCKET报文传输 在SOCKET请求/响应体中包含XM.形式的报文。对SOCKET传输的基本要求如下： 使用TCP发送消息 消息请求基于TCP/IP协议方式。 SOCKET消息头要求 SOCKET请求与响应消息中必须按照如下要求设置： 一个报文必须包含两个部份（报文长度+报文体） 其中： 报文长度=报文体长度，值包含在报文体内xnh节点内 报文长度为一个4位长度的值。 报文最大长度不能超过9999 报文编码格式为：GBK SOCKET报文样例 报文样例《取冲正为例） 0244root n?ssage versi on1.1.0/versi on i nstidLCm：/instid transcode2001/transcode serial no2013031300000001/seri al no dat10:17: 06/date ol dseri al no2013031300000006/ol dseri al no / rr?ssage /r oot  2 与信货接口 2.1批量文件交互 采用FTP方式，服务器之间通过文件服务器进行文件交互。 2.1.1自扣接口 （一） 自扣文件 批量接口 名称 自扣文件 文件命名 规范 0309