2024年3月24日发(作者:)
中信银行银企直联接口说明书(腾讯财付通项目)
中信银行银企直联
接口说明书
(腾讯财付通项目)
第I页
中信银行银企直联接口说明书(腾讯财付通项目)
目 录
第一章 报文结构 ..................................................................................................................................................... 3
1.1 HTTP请求报文 .......................................................................................................................................... 3
1.2 HTTP响应报文 .......................................................................................................................................... 3
第二章 报文定义规则 ............................................................................................................................................. 4
2.1 XML报文格式 ........................................................................................................................................... 4
2.2 信息代码 .................................................................................................................................................... 4
2.3 数据项说明 ................................................................................................................................................ 5
第三章 报文接口 ..................................................................................................................................................... 6
3.1 账户管理 .................................................................................................................................................... 6
3.1.1 交易明细下载 ................................................................................................................................. 6
3.1.1.1 请求报文 .............................................................................................................................. 6
3.1.1.2 响应报文 .............................................................................................................................. 7
3.2 支付转账 .................................................................................................................................................... 8
3.2.1 对外支付批量提交 ......................................................................................................................... 8
3.2.1.1 请求报文 .............................................................................................................................. 8
3.2.1.2 响应报文 ............................................................................................................................ 10
3.2.2 对外支付查询 ............................................................................................................................... 11
3.2.2.1 请求报文 ............................................................................................................................ 11
3.2.2.2 响应报文 ............................................................................................................................ 11
3.2.3 内部转账批量提交 ....................................................................................................................... 14
3.2.3.1 请求报文 ............................................................................................................................ 14
3.2.3.2 响应报文 ............................................................................................................................ 15
3.2.4 内部转账查询 ............................................................................................................................... 16
3.2.4.1 请求报文 ............................................................................................................................ 16
3.2.4.2 响应报文 ............................................................................................................................ 16
第四章 附录 ........................................................................................................................................................... 19
4.1 证件类型 .................................................................................................................................................. 19
4.2 制单状态 .................................................................................................................................................. 19
第II页
中信银行银企直联接口说明书(腾讯财付通项目)
第一章 报文结构
在企业内部局域网环境内,报文的传输方式采用HTTP协议。HTTP报文包
括企业内部系统向前置服务器(客户端软件)的请求报文以及前置服务器(客户
端软件)向企业内部系统的响应报文,均由HTTP报文头与HTTP报文体两部分
构成。
1.1 HTTP请求报文
HTTP请求报文由HTTP报文头(请求行、通用信息、请求头、实体头)、回
车换行(CRLF)、HTTP报文体构成。
HTTP请求报文采用POST方式提交。
HTTP报文体为报文接口定义的请求报文数据(XML报文数据)。
1.2 HTTP响应报文
前置服务器处理HTTP请求报文后,返回HTTP响应报文至企业内部系统。
HTTP响应报文由HTTP报文头(状态行、通用信息、响应头、实体头)、回车
换行(CRLF)、HTTP报文体构成。
HTTP报文体为报文接口定义的响应报文数据(XML报文数据)。
第3页
中信银行银企直联接口说明书(腾讯财付通项目)
第二章 报文定义规则
2.1 XML报文格式
所有XML报文均遵循以下数据格式:
…
其中,list循环域中放置重复数据记录。
报文中的数据项标签名称必须与接口定义中的数据项标签名称一致(包括大
小写)。
2.2 信息代码
响应报文中返回的信息代码(见status字段),含义如下:
信息代码
AAAAAAA
AAAAAAB
AAAAAAC
AAAAAAD
AAAAAAE
含义
交易处理成功;
经办成功待审核;
预约支付成功;
现金管理代理收款信息查询交易专用,表示扣款方审核通过,扣款成功;
已提交银行处理,需稍后使用“交易状态查询”交易(见3.7.1)进行查询;
第4页
中信银行银企直联接口说明书(腾讯财付通项目)
AAAAAAF
BBBBBBB
CCCCCCC
EEEEEEE
UNKNOWN
其他
批次导入提交成功;
批次处理部分成功;
交易处理中;
交易未产生;
交易状态未知;
两位字母+数字的组合为网银错误代码,其他为后台错误代码。错误信息
见statusText字段,以中文表示。
2.3 数据项说明
金额数据项格式为:15,2,即:小数部分为2位,整数部分为13位,最小值
为0.00,最大值为9999999999999.99。
日期数据项格式为:YYYYMMDD,例如:20080630。
时间数据项格式为:hhmmss,例如:230000。
报文接口中的数据项默认不能为空,若可为空的数据项将有相应说明。
第5页
中信银行银企直联接口说明书(腾讯财付通项目)
第三章 报文接口
3.1 账户管理
3.1.1
交易明细下载
对应请求代码:DLTRNDDW
说明:提供指定账户、日期时间段内的交易明细信息文件的下载。其中起始
日期不能早于1年之前,起始截止日期的间隔必须在30天之内。
将返回报文中的交易明细文件内容(fileContent)使用base64方式进行解码后
可以得到交易明细.zip文件,将zip文件进行解压缩后得到.txt交易明细信息文件,
txt文件的文件名为返回报文中字段fileNm(交易明细文件名称)的值,该txt文件
中的内容即为返回报文中账号、交易日期所对应的交易明细信息。
3.1.1.1
请求报文
第6页
中信银行银企直联接口说明书(腾讯财付通项目)
3.1.1.2
响应报文
char(8) 格式
第7页
中信银行银企直联接口说明书(腾讯财付通项目)
3.2 支付转账
3.2.1
对外支付批量提交
对应请求代码: DLOUTTNB
说明:对外转账交易的批量提交。
3.2.1.1
请求报文
第8页
中信银行银企直联接口说明书(腾讯财付通项目)
第9页
中信银行银企直联接口说明书(腾讯财付通项目)
3.2.1.2
响应报文
第10页
中信银行银企直联接口说明书(腾讯财付通项目)
3.2.2
对外支付查询
对应请求代码:DLOUTQRY
说明:查询对外转账批量提交的交易结果。
3.2.2.1
请求报文
3.2.2.2
响应报文
第11页
中信银行银企直联接口说明书(腾讯财付通项目)
第12页
中信银行银企直联接口说明书(腾讯财付通项目)
第13页
中信银行银企直联接口说明书(腾讯财付通项目)
3.2.3
内部转账批量提交
对应请求代码: DLINTRNB
说明:内部转账交易的批量提交。
3.2.3.1
请求报文
char(8) 格式
第14页
中信银行银企直联接口说明书(腾讯财付通项目)
3.2.3.2
响应报文
第15页
中信银行银企直联接口说明书(腾讯财付通项目)
3.2.4
内部转账查询
对应请求代码:DLINEQRY
说明:查询内部转账批量提交的交易结果。
3.2.4.1
请求报文
3.2.4.2
响应报文
第16页
中信银行银企直联接口说明书(腾讯财付通项目)
char(8)格式
第17页
中信银行银企直联接口说明书(腾讯财付通项目)
第18页
中信银行银企直联接口说明书(腾讯财付通项目)
第四章 附录
4.1 证件类型
证件类型代码
0
1
2
3
4
7
8
证件类型
居民身份证
武装警察身份证
护照
军人身份证
港澳居民往来身份证
台湾居民大陆往来通行证
其他
4.2 制单状态
制单状态
0
1
2
3
4
5
6
7
8
9
10
11
12
状态描述
未审核
审核拒绝
审核成功,等待继续审核
审核完成
预约成功
预约被取消
主机处理中
交易成功
交易失败
撤销
状态未知
线程处理中
撤销状态未知
第19页


发布评论