资金清算系统接口V12.docx
《资金清算系统接口V12.docx》由会员分享，可在线阅读，更多相关《资金清算系统接口V12.docx（31页珍藏版）》请在冰点文库上搜索。
资金清算系统接口V12
兴业信用卡资金清算相关接口
修订记录1
1资金清算系统报文结构3
2.1报文分类3
2.2报文的解析与传输3
2.2.1报文解析3
2.2.2SOCKET报文传输4
2.2.3SOCKET报文样例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（银行编码）
1资金清算系统报文结构
资金清算系统报文统一采用xml格式。
所有的报文均以root作为根元素，每个root元素中只有一个message元素。
message元素中包含代表具体的业务的元素。
每个业务元素由一系列属性元素构成，不同的业务元素中包含的属性元素有所不同。
作为约定，root元素、message元素与业务元素均是小写字母的形式。
以放款请求报文为例，报文的格式如下：
在下文中出现的具体报文格式描述中，“出现要求”列包含的值的含义如下表所示：
符号
含义
请求方约束
服务方约束
R
Required（必须的）
必须包含该域
必须校验该域是否存在和内容的合法性
C
Conditional（有条件的）
如果条件符合必须包含该域
●当条件满足时，必须校验该域是否存在
●当该域存在时，必须检查其内容的合法性
O
Optional（可选的）
该域可选
当该域存在时，必须检查其内容的合法性
2.1报文分类
资金清算系统中的报文按照交互模式的不同，分为以下几类
⏹服务请求类报文
服务请求类报文用于请求-应答交互模式，由服务使用者向服务提供者发送。
⏹服务应答类报文
服务应答类报文用于请求-应答交互模式，由服务提供者向服务使用者返回。
⏹通知类报文
通知类报文用于单向通知交互模式，由通知发送者向通知接收者发送。
2.2报文的解析与传输
2.2.1报文解析
对XML解析的基本要求如下
⏹版本号检查
用于表示组件支持的协议版本号。
消息版本号必须表示为：
n+.n+[.n+]，其中“n”表示数字，“+”表示一个或多个。
比如1.0或1.1.0。
在所有的消息中，各组件都必须填写自身支持的协议版本号。
消息版本号不能低于1.1.0。
如果消息版本号低于接收方组件支持的最低版本号，则接收方组件必须返回Error消息，并且设置错误码=0006。
⏹xml解析
为了可以支持后续协议版本，xml解析的实现不要做严格的验证。
特别是需要忽略未被确认的域。
所有xml消息必须用“GBK”编码。
2.2.2SOCKET报文传输
在SOCKET请求/响应体中包含XML形式的报文。
对SOCKET传输的基本要求如下：
⏹使用TCP发送消息
消息请求基于TCP/IP协议方式。
⏹SOCKET消息头要求
SOCKET请求与响应消息中必须按照如下要求设置：
一个报文必须包含两个部份（报文长度+报文体）
其中:
报文长度=报文体长度，MAC值包含在报文体内xml节点内
报文长度为一个4位长度的值。
报文最大长度不能超过9999
报文编码格式为：
GBK
2.2.3SOCKET报文样例
报文样例（取冲正为例）
0244
1.1.0
LOAN
2001
2013031300000001
2013031310:
17:
06
2013031300000006
2与信货接口
2.1批量文件交互
采用FTP方式，服务器之间通过文件服务器进行文件交互。
2.1.1自扣接口
（一）自扣文件
批量接口名称
自扣文件
文件命名规范
0309-AUOREP-XXXX-YYYYMMDD
（YYYYMMDD为年月日）
（XXXX为批次号，当天唯一）
批量接口说明
1．记录换行符“\n”
传输发起方
消费消费信贷系统
传输目的地
资金清算系统主动取
/UPLOAD/YYYYMMDD
频率
通过报文交易通知
传输方式
FTP
批量接口数据流程
字段名
类型
长度
备注
是否必填
记录产生日期
字符型
8
YYYYMMDD
是
流水号
数字型
30
唯一（系统存在期间内保持唯一）
是
信贷号（相当于信用卡号）
字符型
40
左对齐，右补空格
是
证件类型
字符型
2
见附件一
是
证件号
字符型
20
左对齐，右补空格
是
持卡人姓名
字符型
40
左对齐，不足右补空格
否
本他行标志
字符型
1
0本行1他行
是
客户账号
字符型
20
左对齐，右补空格
是
银行代号
字符型
4
是扣款银行代号，见附件二
是
扣账金额
数字型
12
整数10位，小数2位，右对齐左补0，如1234.56就是000000123456
是
扣账币种
字符型
3
156：
人民币；840：
美元
是
扣账日期
字符型
8
YYYYMMDD
是
（二）自扣结果文件
批量接口名称
自扣结果文件
文件命名规范
0309-AUORSP-XXXX-YYYYMMDD
（YYYYMMDD为年月日）
（XXXX为批次号，当天唯一）
批量接口说明
1．若自扣文件是空文件，则返回也是空文件
2．以下字段，若不加以特殊说明为回盘文件返回的，在返回的时候将原文件中该字段内容原样返回即可
3．记录换行符“\n”
传输发起方
资金清算系统
传输目的地
资金清算系统主动上送
/DOWNLOAD/YYYYMMDD
频率
通过报文交易通知
传输方式
FTP
批量接口数据流程
字段名
类型
长度
备注
是否必填
记录产生日期
字符型
8
回盘文件中填写，YYYYMMDD
是
扣款流水号
数字型
30
唯一（系统存在期间内保持唯一）
是
信贷号（相当于信用卡号）
字符型
40
左对齐，右补空格
是
证件类型
字符型
2
见附件一
是
证件号
字符型
20
左对齐，右补空格
是
持卡人姓名
字符型
40
左对齐，不足右补空格
否
扣账客户帐号
字符型
20
左对齐，右补空格
是
银行代号
字符型
4
是扣款银行代号，见附件二
是
扣账金额
数字型
12
整数10位，小数2位，右对齐左补0，如1234.56就是000000123456
是
扣账币种
字符型
3
156：
人民币；840：
美元
是
扣账日期
字符型
8
YYYYMMDD
是
实际扣账金额
数字型
12
回盘文件中填写
整数10位，小数2位，右对齐左补0
是
实际扣帐日期
字符型
8
回盘文件中填写YYYYMMDD
是
处理响应码
字符型
2
回盘文件中填写
‘00’：
成功
‘14’：
无效账号
‘99’：
其它原因错误（余额不足时候也返回99）
是
处理响应结果详细描述
字符型
50
回盘文件中填写
对于99类错误的详细描述
否
保留字段
字符型
50
回盘文件中填写,暂不使用
左对齐，右补空格
否
2.1.2放款接口
（三）放款文件
批量接口名称
放款文件
文件命名规范
0309-LOANREP-XXXX-YYYYMMDD
（YYYYMMDD为年月日）
（XXXX为批次号，当天唯一）
批量接口说明
1．记录换行符“\n”
传输发起方
消费消费信贷系统
传输目的地
资金清算系统主动取
/UPLOAD/YYYYMMDD
频率
通过报文交易通知
传输方式
FTP
批量接口数据流程
字段名
类型
长度
备注
是否必填
记录产生日期
字符型
8
YYYYMMDD
是
流水号
数字型
30
唯一（系统存在期间内保持唯一）
是
信贷号（相当于信用卡号）
字符型
40
左对齐，右补空格
是
证件类型
字符型
2
见附件一
是
证件号
字符型
20
左对齐，右补空格
是
持卡人姓名
字符型
40
左对齐，不足右补空格
否
本他行标志
字符型
1
0本行1他行
是
客户账号
字符型
20
左对齐，右补空格
是
放款金额
数字型
12
整数10位，小数2位，右对齐左补0，如1234.56就是000000123456
是
放款币种
字符型
3
156：
人民币；840：
美元
是
放款日期
字符型
8
YYYYMMDD
是
（四）放款结果文件
批量接口名称
放款结果文件
文件命名规范
0309-LOANRSP-XXXX-YYYYMMDD
（YYYYMMDD为年月日）
（XXXX为批次号，当天唯一）
批量接口说明
1．若放款文件是空文件，则返回也是空文件
2．以下字段，若不加以特殊说明为回盘文件返回的，在返回的时候将原文件中该字段内容原样返回即可
3．记录换行符“\n”
传输发起方
资金清算系统
传输目的地
资金清算系统主动上送
/DOWNLOAD/YYYYMMDD
频率
通过报文交易通知
传输方式
FTP
批量接口数据流程
字段名
类型
长度
备注
是否必填
记录产生日期
字符型
8
回盘文件中填写，YYYYMMDD
是
流水号
数字型
30
唯一（系统存在期间内保持唯一）
是
信贷号（相当于信用卡号）
字符型
40
左对齐，右补空格
是
证件类型
字符型
2
见附件一
是
证件号
字符型
20
左对齐，右补空格
是
持卡人姓名
字符型
40
左对齐，不足右补空格
否
扣账客户账号
字符型
20
左对齐，右补空格
是
银行代号
字符型
4
是放款银行代号，见附件二
是
放款金额
数字型
12
整数10位，小数2位，右对齐左补0，如1234.56就是000000123456
是
扣账币种
字符型
3
156：
人民币；840：
美元
是
放款日期
字符型
8
YYYYMMDD
是
实际放款金额
数字型
12
回盘文件中填写
整数10位，小数2位，右对齐左补0
是
实际放款日期
字符型
8
回盘文件中填写YYYYMMDD
是
处理响应码
字符型
2
回盘文件中填写
‘00’：
成功
‘14’：
无效账号
‘99’：
其它原因错误（余额不足时候也返回99）
是
处理响应结果详细描述
字符型
50
回盘文件中填写
对于99类错误的详细描述
否
保留字段
字符型
50
回盘文件中填写,暂不使用
左对齐，右补空格
否
2.2批量文件通知报文
批量文件通知请求报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
8001
流水号
serialno
char（19）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
文件类型
filetype
char
（1）
R
1-放款请求文件
2-放款结果文件
3-自扣请求文件
4-自扣结果文件
5-自扣入账通知文件
文件名称
filename
char（30）
R
文件摘要
digest
char（40）
C
批量文件通知应答报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
流水号
serialno
char（19）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
响应代码
errorcode
char（4）
R
响应信息
errmsg
char（60）
C
2.3实时交互方式
2.3.1自扣接口
自扣请求报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
1001
流水号
serialno
char（30）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
信贷号（相当于信用卡号）
card_nbr1
char（40）
R
证件类型
cust_type
char
（2）
R
证件号
cust_nbr
char（20）
R
持卡人姓名
curname
char（40）
R
本他行标志
flag
char
（1）
R
0本行
1他行
扣账借记卡卡号
card_nbr2
char（20）
R
扣账金额
amt
char（12）
R
整数10位，小数2位，右对齐左补0，如1234.56就是000000123456
扣账币种
cur
char（3）
R
156：
人民币；840：
美元
银行编码
bank_code
Char（4）
R
自扣结果报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
1001
流水号
serialno
char（30）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
响应代码
errorcode
char（4）
R
响应信息
errmsg
char（60）
C
实际扣账金额
amt
char（12）
2.3.2放款接口
放款请求报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
1002
流水号
serialno
char（30）
R
唯一（系统存在期间内保持唯一）
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
信贷号（相当于信用卡号）
card_nbr1
char（40）
R
见附件一
证件类型
cust_type
char
（2）
R
证件号
cust_nbr
char（20）
R
持卡人姓名
curname
char（40）
R
本他行标志
flag
char
（1）
R
0本行
1他行
借记卡卡号
card_nbr2
char（20）
R
金额
amt
char（12）
R
整数10位，小数2位，右对齐左补0，如1234.56就是000000123456
币种
cur
char（3）
R
156：
人民币；840：
美元
银行编码
bank_code
Char（4）
R
放款结果报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
1002
流水号
serialno
char（30）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
响应代码
errorcode
char（4）
R
响应信息
errmsg
char（60）
C
实际放款金额
amt
char（12）
2.3.3冲正接口（第三方不支持）
当冲正交易为他行卡业务时，系统会直接返回失败，并提示“借记卡为他行，无法冲正”
冲正请求报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
2001
流水号
serialno
char（30）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
原交易流水号
oldserialno
char（30）
R
原交易流水号
冲正结果报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
2001
流水号
serialno
char（30）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
响应代码
errorcode
char（4）
R
响应信息
errmsg
char（60）
C
2.3.4查询接口
对于某笔超时的实时交易需要查询结果，超时后3分钟内，相邻查询时间间隔不应短于20秒
在超时后3-10分钟内，相邻查询时间间隔不应短于1分钟
在超时后10分钟以上的，相邻查询时间间隔不应短于5分钟
对于30分钟内一直返回失败的，应确认该笔交易失败，平台没有成功接收，应立刻停止继续查询。
注：
如果是他行实时自扣交易，请在1小时以后再进行查询。
并每次间隔不少于半小时
查询请求报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
3001
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
交易性质
type
char
（1）
R
0放款
1还款
查询流水号
oldserialno
char（30）
R
查询的原交易流水号
查询结果报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
3001
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
查询流水号
serialno
char（19）
R
响应代码
errorcode
char（4）
R
响应信息
errmsg
char（60）
C
交易日期
olddate
char（17）
R
借记卡卡号
bankcardno
char（45）
R
交易金额
amt
Long（12）
R
整数10位，小数2位，右对齐左补0，如1234.56就是000000123456
交易货币代码
currency
char（3）
R
交易状态
status
char（4）
R
0000：
失败（代表账务处理失败）
0001：
成功（代表账务处理成功）
0002：
处理中（代表处理中间状态）
0003：
查无此订单。
2.3.5同名验证接口
同名验证报文
中文域名
对应DTD元素
类型
出现要求
说明
版本号
version
char（7）
R
目前版本号：
1.1.0
机构标识
instid
char（6）
R
LOAN消费信贷系统
MBP资金清算系统
交易代码
transcode
char（4）
R
4001
流水号
serialno
char（30）
R
交易流水号
交易日期和时间
date
char（17）
R
YYYYMMDDHH:
MM:
SS
交易类型
transtype
char
（1）
R
0新增
1修改（目前第三方不支持）
2删除（目前第三方不支持）
信贷号（相当于信用卡号）
升级会员 