文档介绍:中信银行银企直联
接口说明书(电子商务)
版本
目 录
第一章 报文结构 1
HTTP请求报文 1
HTTP响应报文 1
第二章 报文定义规则 2
XML报文格式 2
信息代码 2
数据项说明 3
第三章 报文接口 4
电子商务网上支付 4
指定时间段订单查询 4
请求报文 4
响应报文 4
对账文件下载 6
请求报文 6
响应报文 6
订单通知查询 7
请求报文 7
响应报文 8
订单通知查询确认 8
请求报文 9
响应报文 9
第三方商户充值退回经办 9
请求报文 9
响应报文 10
第三方商户充值退回汇总查询 11
请求报文 11
响应报文 12
第三方商户充值退回明细查询 13
请求报文 13
响应报文 14
第三方商户提现经办 15
请求报文 15
响应报文 16
第三方商户提现汇总查询 17
请求报文 17
响应报文 17
第三方商户提现明细查询 18
请求报文 18
响应报文 19
B2C商户退款经办 20
请求报文 20
响应报文 21
B2C商户退款汇总查询 22
请求报文 22
响应报文 23
B2C商户退款明细查询 24
请求报文 24
响应报文 24
多渠道商务平台 25
订单信息新增 25
请求报文 26
响应报文 28
订单状态修改 28
请求报文 28
响应报文 29
上下行短信查询 29
请求报文 29
返回报文 30
交易结果查询 31
请求报文 31
响应报文 31
第四章 附录 34
证件类型 34
批次受理状态 34
交易状态 34
报文结构
在企业内部局域网环境内,报文的传输方式采用HTTP协议。HTTP报文包括企业内部系统向前置服务器(客户端软件)的请求报文以及前置服务器(客户端软件)向企业内部系统的响应报文,均由HTTP报文头与HTTP报文体两部分构成。
HTTP请求报文
HTTP请求报文由HTTP报文头(请求行、通用信息、请求头、实体头)、回车换行(CRLF)、HTTP报文体构成。
HTTP请求报文采用POST方式提交。
HTTP报文体为报文接口定义的请求报文数据(XML报文数据)。
HTTP响应报文
前置服务器处理HTTP请求报文后,返回HTTP响应报文至企业内部系统。HTTP响应报文由HTTP报文头(状态行、通用信息、响应头、实体头)、回车换行(CRLF)、HTTP报文体构成。
HTTP报文体为报文接口定义的响应报文数据(XML报文数据)。
报文定义规则
XML报文格式
所有XML报文均遵循以下数据格式:
<?xml version="" encoding="GBK"?>
<stream>
<key1>value1</key1>
<key2>value2</key2>
<list name="userDataList">
<row>
<key3>value3</key3>
…
</row>
</list>
</stream>
其中,list循环域中放置重复数据记录。
报文中的数据项标签名称必须与接口定义中的数据项标签名称一致(包括大小写)。
信息代码
响应报文中返回的信息代码(见status字段),含义如下:
信息代码
含义
AAAAAAA
交易处理成功;
AAAAAAB
经办成功待审核;
AAAAAAC
预约支付成功;
AAAAAAD
现金管理代理收款信息查询交易专用,表示扣款方审核通过,扣款成功;
AAAAAAE
已提交银行处理,需稍后