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报文均遵循以下数据格式:

value1

value2

value3

其中,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

请求报文

DLTRNDDW

第6页

中信银行银企直联接口说明书(腾讯财付通项目)

3.1.1.2

响应报文

char(8) 格式

第7页

中信银行银企直联接口说明书(腾讯财付通项目)

3.2 支付转账

3.2.1

对外支付批量提交

对应请求代码: DLOUTTNB

说明:对外转账交易的批量提交。

3.2.1.1

请求报文

DLOUTTNB

第8页

中信银行银企直联接口说明书(腾讯财付通项目)

第9页

中信银行银企直联接口说明书(腾讯财付通项目)

3.2.1.2

响应报文

第10页

中信银行银企直联接口说明书(腾讯财付通项目)

3.2.2

对外支付查询

对应请求代码:DLOUTQRY

说明:查询对外转账批量提交的交易结果。

3.2.2.1

请求报文

DLOUTQRY

3.2.2.2

响应报文

第11页

中信银行银企直联接口说明书(腾讯财付通项目)

第12页

中信银行银企直联接口说明书(腾讯财付通项目)

第13页

中信银行银企直联接口说明书(腾讯财付通项目)

3.2.3

内部转账批量提交

对应请求代码: DLINTRNB

说明:内部转账交易的批量提交。

3.2.3.1

请求报文

DLINTRNB

char(8) 格式

第14页

中信银行银企直联接口说明书(腾讯财付通项目)

3.2.3.2

响应报文

第15页

中信银行银企直联接口说明书(腾讯财付通项目)

3.2.4

内部转账查询

对应请求代码:DLINEQRY

说明:查询内部转账批量提交的交易结果。

3.2.4.1

请求报文

DLINEQRY

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页