首页 > 中信银行银企直联接口使用规范(必读)

中信银行银企直联接口使用规范(必读)

发布时间：来源：文档文库

小中大

字号：

手机查看

可编辑

中信银行银企直联接口使用规范
（必读）
版本V1.0.0.0
精品

可编辑
目录
一、概述..........................................................................................................................................................1
1.1文档用途.............................................................................................................................................11.2适用对象.............................................................................................................................................1二、报文结构..................................................................................................................................................1
2.1HTTP请求报文.................................................................................................................................12.2HTTP响应报文.................................................................................................................................1三、报文定义规则..........................................................................................................................................1
3.1XML报文格式...................................................................................................................................13.2响应报文说明.....................................................................................................................................23.3响应码.................................................................................................................................................2
3.3.1客户端响应码..........................................................................................................................33.3.2服务器端响应码......................................................................................................................3
四、典型交易说明..........................................................................................................................................4
4.1动账类.................................................................................................................................................44.2查询类.................................................................................................................................................4
精品

可编辑
一、概述
1.1文档用途
此文档作为银企直联客户的必读手册，用于说明中信银行银企直联系统的接口规范。银企直联客
户须严格按照该规范使用银企直联接口，避免因接口使用不当导致重复动账、资金损失。
1.2适用对象
中信银行银企直联客户。
二、报文结构
在企业内部局域网环境内，报文的传输方式采用HTTP协议。HTTP报文包括企业内部系统向前置服务器（客户端软件）的请求报文以及前置服务器（客户端软件）向企业内部系统的响应报文，均由HTTP报文头与HTTP报文体两部分构成。
2.1HTTP请求报文
HTTP请求报文由HTTP报文头（请求行、通用信息、请求头、实体头、回车换行（CRLF）、HTTP报文体构成。
HTTP请求报文采用POST方式提交。
HTTP报文体为报文接口定义的请求报文数据（XML报文数据）。
2.2HTTP响应报文
前置服务器处理HTTP请求报文后，返回HTTP响应报文至企业内部系统。HTTP响应报文由HTTP报文头（状态行、通用信息、响应头、实体头）、回车换行（CRLF）、HTTP报文体构成。
HTTP报文体为报文接口定义的响应报文数据（XML报文数据）。
三、报文定义规则
3.1XML报文格式
所有XML报文均遵循以下数据格式：

value1
精品

可编辑
value2

value3…

。
其中，list循环域中放置重复数据记录。
报文中的数据项标签名称必须与接口定义中的数据项标签名称一致（包括大小写）。
3.2响应报文说明
HTTP响应报文均遵循以下格式：

响应码
响应信息描述……
valueN
银企直联响应报文中均包含status、statusText两个字段，status标签对应信息为交易响应码，statusText标签对应信息为交易响应码的中文描述。
3.3响应码
一个完整的交易由请求报文、响应报文两部分组成，其中，响应报文中用于表示该交易请求处理状态的标志，称为响应码。响应码是由字母+数字的组合的交易信息代码，长度为7位。响应码主要分为两类：客户端响应码和服务器端响应码。
精品

可编辑
银企直联交易主要分为动账类、查询类两种。动账类交易的响应码用于表示该交易请求的银行受理状态，而非该交易的账务状态。查询类交易的响应码用于表示该查询交易的查询处理过程是否成功，
精品

可编辑
而非被查交易信息的账务状态，被查交易的交易状态信息需根据响应报文相应状态字段信息确定。
3.3.1客户端响应码
当银企直联客户端因企业端环境、网络等问题导致与银行服务器端无法进行正常通讯时，若企业端系统给银企直联客户端发送交易请求，则银企直联客户端会给企业端系统返回客户端响应码。
客户端响应码均以“ET”、“CF09”、“CF14”、“CF15”、“CF18”、“CF19”、“CF20”、“CF21”、“CF22”、“CF23”、“CM12”、“ED10”、“ED11”、“ED12”开头。
特别说明：
当银企直联客户端返回客户端响应码时，无法确定当前交易银行端是否处理成功。➢若当前交易为查询类交易，则客户可稍后重新进行查询。
➢若当前交易为动账类交易，则客户务必先进行当前交易对应的交易状态查询确认真实交易
状态或联系中信银行进行交易状态确认，切勿重新发起动账交易造成重复动账、资金损失。
3.3.2服务器端响应码
若银企直联客户端与银行服务器端通讯正常，当企业端系统给银企直联客户端发送交易请求时，银企直联客户端会给企业端系统返回服务器端响应码。
服务器端响应码：
响应码
AAAAAAAAAAAAABAAAAAACAAAAAADAAAAAAEAAAAAAFAAAAAAGAAAAAAHAAAAAAKBBBBBBBCCCCCCC
含义
交易处理成功；经办成功待审核；预约支付成功；
现金管理代理收款信息查询交易专用，表示扣款方审核通过，扣款成功；已提交银行处理，需稍后使用“交易状态查询”交易进行查询；批次导入提交成功；
已提交银行处理，需稍后使用“票据状态同步”交易进行查询；已提交银行处理，需稍后使用“电子合同确认查询”交易进行查询；