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

中信银行 银企直联接口使用规范 （必读） 版本 V 目 录 一、 概述 1 1.1文档用途 1 1.2适用对象 1 二、 报文结构 1 2.1 HTTP请求报文 1 2.2 HTTP响应报文 1 三、 报文定义规则 1 3.1 XML报文格式 1 3.2响应报文说明 2 3.3响应码 2 3.3.1客户端响应码 3 3.3.2服务器端响应码 3 四、 典型交易说明 4 4.1动账类 4 4.2查询类 4 概述 1.1文档用途 中信银行。 1.2适用对象 中信银行。 2.1 HTTP请求报文 HTTP请求报文由HTTP报文头（请求行、通用信息、请求头、实体头)、回车换行（CRLF）、HTTP报文体构成。 HTTP请求报文采用POST方式提交。 HTTP报文体为报文接口定义的请求报文数据（XML报文数据）。 2.2 HTTP响应报文 前置服务器处理HTTP请求报文后，返回HTTP响应报文至企业内部系统。HTTP响应报文由HTTP报文头（状态行、通用信息、响应头、实体头）、回车换行（CRLF）、HTTP报文体构成。 HTTP报文体为报文接口定义的响应报文数据（XML报文数据）。 报文定义规则 3.1 XML报文格式 所有XML报文均遵循以下数据格式： ?xml version=1.0 encoding=GBK? stream key1value1/key1 key2value2/key2 list name=userDataList row key3value3/key3 … /row /list /stream。 其中，list循环域中放置重复数据记录。 报文中的数据项标签名称必须与接口定义中的数据项标签名称一致（包括大小写）。 3.2响应报文说明 HTTP响应报文均遵循以下格式： ?xml version=1.0 encoding=GB2312? stream status响应码/status statusText响应信息描述/statusText …… keyNvalueN/keyN /stream 银企直联响应报文中均包含status、statusText两个字段，status标签对应信息为交易响应码，statusText标签对应信息为交易响应码的中文描述。 3.3响应码 一个完整的交易由请求报文、响应报文两部分组成，其中，响应报文中用于表示该交易请求处理状态的标志，称为响应码。响应码是由字母+数字的组合代码。.3.1客户端响应码 当银企直联客户端因企业端环境、网络等问题导致与银行服务器端无法进行正常通讯时，若企业端系统给银企直联客户端发送交易请求，则银企直联客户端会给企业端系统返回客户端响应码。 客户端响应码均以“ET”、“CF09”、“CF14”、“CF15”、“CF18”、“CF19”、“CF20”、“CF21”、“CF22”、“CF23”、“CM12”、“ED10”、“ED11”、“ED12”开头。 特别说明： 当银企直联客户端返回客户端响应码时，无法确定当前交易银行端是否处理成功。 若当前交易为查询类交易，则客户可稍后重新进行查询。 若当前交易为动账类交易，则客户务必先进行当前交易对应的交易状态查询确认真实交易状态或联系中信银行进行交易状态确认，切勿重新发起动账交易造成重复动账、资金损失。 3.3.2服务器端响应码 若银企直联客户端与银行服务器端通讯正常，当企业端系统给银企直联客户端发送交易请求时，银企直联客户端会给企业端系统返回服务器端响应码。 服务器端响应码： 响应码 含义 AAAAAAA 交易处理成功 AAAAAAB 经办成功待审核 AAAAAAC 预约支付成功 AAAAAAD 现金管理代理收款信息查询交易专用，表示扣款方审核通过，扣款成功 AAAAAAE 已提交银行处理，需稍后使用交易状态查询交易进行查询 AAAAAAF 批次导入提交成功 AAAAAAG 已提交银行处理，需稍后使用状态交易进行查询 AAAAAAH 已提交银行处理，需稍后使用“电子合同确认查询”交易进行查询； AAAAAAK 已提交银行处理，需稍后使用状态交易进行查询 BBBBBBB 批次处理成功 CCCCCCC 交易处理中 EEEEEEE 交易未产生 UNKNOWN 交易状态未知 其他 +数字的组合为代码。信息见statusText字段，以中文表示。 4.1动账类（单笔） 当客户提交单笔动账类交易请求成功时，仅能说明交易提交银行成功，无法确定交易的真实账务状态，必须进行相应的交易状态查询以明确真实的交易状态。 举例说明： 当客户发送对外支付（DLOUTTRN）交易成功时，仅说明交易提交银行成功，客户必须根据当前交易的客户流水号、交易请