中信银行银企直联接口说明书电子商务V5000.docx
- 文档编号:17036043
- 上传时间:2023-07-21
- 格式:DOCX
- 页数:29
- 大小:24.34KB
中信银行银企直联接口说明书电子商务V5000.docx
《中信银行银企直联接口说明书电子商务V5000.docx》由会员分享,可在线阅读,更多相关《中信银行银企直联接口说明书电子商务V5000.docx(29页珍藏版)》请在冰点文库上搜索。
中信银行银企直联接口说明书电子商务V5000
中信银行银企直联
接口说明书(电子商务)
版本V5.0.0.0
第一章报文结构1
1.1HTTP请求报文1
1.2HTTP响应报文1
第二章报文定义规则2
2.1XML报文格式2
2.2信息代码2
2.3数据项说明3
第三章报文接口4
3.1电子商务网上支付4
3.1.1指定时间段订单查询4
3.1.1.1请求报文4
3.1.1.2响应报文4
3.1.2对账文件下载6
3.1.2.1请求报文6
3.1.2.2响应报文6
3.1.3订单通知查询7
3.1.3.1请求报文7
3.1.3.2响应报文8
3.1.4订单通知查询确认8
3.1.4.1请求报文9
3.1.4.2响应报文9
3.1.5第三方商户充值退回经办9
3.1.5.1请求报文9
3.1.5.2响应报文10
3.1.6第三方商户充值退回汇总查询11
3.1.6.1请求报文11
3.1.6.2响应报文12
3.1.7第三方商户充值退回明细查询13
3.1.7.1请求报文13
3.1.7.2响应报文14
3.1.8第三方商户提现经办15
3.1.8.1请求报文15
3.1.8.2响应报文16
3.1.9第三方商户提现汇总查询17
3.1.9.1请求报文17
3.1.9.2响应报文17
3.1.10第三方商户提现明细查询18
3.1.10.1请求报文18
3.1.10.2响应报文19
3.1.11B2C商户退款经办20
3.1.11.1请求报文20
3.1.11.2响应报文21
3.1.12B2C商户退款汇总查询22
3.1.12.1请求报文22
3.1.12.2响应报文23
3.1.13B2C商户退款明细查询24
3.1.13.1请求报文24
3.1.13.2响应报文24
3.2多渠道商务平台25
3.2.1订单信息新增25
3.2.1.1请求报文26
3.2.1.2响应报文28
3.2.2订单状态修改28
3.2.2.1请求报文28
3.2.2.2响应报文29
3.2.3上下行短信查询29
3.2.3.1请求报文29
3.2.3.2返回报文30
3.2.4交易结果查询31
3.2.4.1请求报文31
3.2.4.2响应报文31
第四章附录34
4.1证件类型34
4.2批次受理状态34
4.3交易状态34
第一章报文结构
在企业内部局域网环境内,报文的传输方式采用HTTP协议。
HTTP报文包括企业内部系统向前置服务器(客户端软件)的请求报文以及前置服务器(客户端软件)向企业内部系统的响应报文,均由HTTP报文头与HTTP报文体两部分构成。
1.1HTTP请求报文
HTTP请求报文由HTTP报文头(请求行、通用信息、请求头、实体头)、回车换行(CRLF)、HTTP报文体构成。
HTTP请求报文采用POST方式提交。
HTTP报文体为报文接口定义的请求报文数据(XML报文数据)。
1.2HTTP响应报文
前置服务器处理HTTP请求报文后,返回HTTP响应报文至企业内部系统。
HTTP响应报文由HTTP报文头(状态行、通用信息、响应头、实体头)、回车换行(CRLF)、HTTP报文体构成。
HTTP报文体为报文接口定义的响应报文数据(XML报文数据)。
第二章报文定义规则
2.1XML报文格式
所有XML报文均遵循以下数据格式:
v?
xmlversion="1.0"encoding="GBK"?
>
其中,list循环域中放置重复数据记录。
报文中的数据项标签名称必须与接口定义中的数据项标签名称一致(包括大小写)
2.2信息代码
响应报文中返回的信息代码(见status字段),含义如下:
信息代码
含义
AAAAAAA
交易处理成功;
AAAAAAB
经办成功待审核;
AAAAAAC
预约支付成功;
AAAAAAD
现金管理代理收款信息查询交易专用,表示扣款方审核通过,扣款成功;
AAAAAAE
已提交银行处理,需稍后使用“交易状态查询”交易进行查询;
AAAAAAF
批次导入提交成功;
BBBBBBB
批次处理部分成功;
CCCCCCC
交易处理中;
EEEEEEE
交易未产生,请务必使用该业务的汇总查询交易确认交易真实状态!
UNKNOWN
交易状态未知;
其他
两位字母+数字的组合为网银错误代码,其他为后台错误代码。
错误信息见statusText字段,以中文表示。
2.3数据项说明
金额数据项格式为:
15,2,即:
小数部分为2位,整数部分为13位,最小值为0.00,
最大值为9999999999999.9Q
日期数据项格式为:
YYYYMMDD,例如:
20080630。
时间数据项格式为:
hhmmss,例如:
230000。
报文接口中的数据项默认不能为空,若可为空的数据项将有相应说明。
第三章报文接口
3.1电子商务网上支付
3.1.1指定时间段订单查询
对应请求代码:
DL3RDORD(第三方支付)、DLB2CORD(直联商户)说明:
查询到指定时间段内的订单信息,查询条数上限定为10000。
3.1.1.1请求报文
xmlversion="1.0"encoding="GBK"?
>
vaction>DL3RDORD
--DL3RDORD(第三方支付)DLB2CORD(直联商户-->
vuserName>v/userName>v!
--登录名varchar(30)-->vqryStartTime>v/qryStartTime>v!
--起始时间YYYYMMDDhhmmss-->vqryEndTime>v/qryEndTime>v!
--截止时间YYYYMMDDhhmmss-->
v/stream>
3.1.1.2响应报文
v?
xmlversion="1.0"encoding="GBK"?
>
vstream>
vstatus>v/status>v!
--交易状态char(7)-->vstatusText>v/statusText>v!
--交易状态信息varchar(254)-->
--订单查询起始时间格式
YYYYMMDDhhmmss-->
--订单查询截止时间格式
YYYYMMDDhhmmss-->
--交易状态char(7)-->
--交易状态信息varchar(254)-->
--订单日期格式YYYYMMDD-->
--订单时间格式hhmmss-->
--订单号char(20)-->
--订单金额decimal(15,2)-->
--支付币种char(3)-->
--支付金额decimal(15,2)-->
--摘要信息char(102)-->
--支付交易流水号char(20)-->
--主机操作日期格式YYYYMMDD-->
--主机操作时间时间格式hhmmss-->
--支付卡号char(19)-->
--卡号类型char
(2)01:
借记卡;02:
信用卡-->
--个人消费者中文姓名varchar(122)-->
3.1.2对账文件下载
对应请求代码:
DL3RDFLE(第三方支付)、DLB2CFLE(直联商户)说明:
提供指定日期对账文件下载。
3.1.2.1请求报文
xmlversion="1.0"encoding="GBK"?
>
--DL3RDFLE(第三方支付)DLB2CFLE(直联商户)-->
--登录名varchar(30)-->
--订单日期格式YYYYMMDD-->
3.1.2.2响应报文
xmlversion="1.0"encoding="GBK"?
>
--交易状态char(7)-->
--交易状态信息varchar(254)-->
--0:
充值退回;1:
充值;2:
提现-->
--总笔数int-->
--总金额deciam(15,2)-->
--文件名-->
--对账文件内容须用base64方式进行解码-->
3.1.3订单通知查询
对应请求代码:
DL3RDNTQ(第三方支付)、DLB2CNTQ(直联商户)说明:
查询已处理的订单通知。
3.1.3.1请求报文
xmlversion="1.0"encoding="GBK"?
>
vaction>DL3RDNTQv/action>
--DL3RDNTQ(第三方支付)DLB2CNTQ(直
联商户)-->
--登录名char(30)-->
3.1.3.2响应报文
xmlversion="1.0"encoding="GBK"?
>
--交易状态char(7)-->
--交易状态信息varchar(254)-->
--查询时间格式YYYYMMDDhhmmss--> --消息列表包括每条消息的消息体--> --消息创建时间格式 YYYYMMDDHHmmss--> --消息内容--> 3.1.4订单通知查询确认 对应请求代码: DL3RDNTC(第三方支付)、DLB2CNTC(直联商户)说明: 确认已经收到已处理的订单通知。 3.1.4.1请求报文 xmlversion="1.0"encoding="GBK"? > --DL3RDNTC(第三方支付)DLB2CNTC(直 联商户)--> --登录名char(30)--> --查询时间YYYYMMDDhhmmss--> 3.1.4.2响应报文 xmlversion="1.0"encoding="GBK"? > --交易状态char(7)--> --交易状态信息varchar(254)--> 3.1.5第三方商户充值退回经办 对应请求代码: DL3RTCJB 说明: 对已充值成功的订单进行充值退回经办提交,支持单笔、批量经办提交。 其中输入的单笔退款金额不能大于原订单的充值金额,一批充值退回中的累计退款金额不能大于原订单的充值金额;同一批交易中的商户充值退回流水号不能重复。 3.1.5.1请求报文 xmlversion="1.0"encoding="GBK"? > --登录名varchar(30)--> --付款账号char(19)--> --客户流水号varchar(20)--> --商户充值退回流水号varchar(20)-- --原订单号varchar(20)--> --原订单日期char(8)格式YYYYMMDD --> --充退金额decimal(15,2)--> vabstractx/abstractx! -扌摘要varchar(102),可空--> 3.1.5.2响应报文 xmlversion="1.0"encoding="GBK"? > -交易状态char(7)--> vstatusTextx/statusTextx! --交易状态信息varchar(254)--> --批次号varchar(8)--> --银行受理成功总笔数int--> --银行受理成功总金额decimal(15,2)--> --银行受理失败总笔数int--> --银行受理失败总金额decimal(15,2)--> --商户充值退回流水号varchar(20)--> --交易银行受理状态char(7)--> --交易银行受理状态信息varchar(254)--> 3.1.6第三方商户充值退回汇总查询 对应请求代码: DL3RTCCL说明: 查询第三方商户充值回退交易的汇总信息,其中查询起始日期不能早于1年以前。 3.1.6.1请求报文 xmlversion="1.0"encoding="GBK"? > vuserNamex/userNamex! -登录名varchar(30)--> --起始日期char(8)格式YYYYMMDD-->vendDate>v/endDate>v! --截止日期char(8)格式YYYYMMDD--> --客户流水号varchar(20),可空-->v/stream> 3.1.6.2响应报文 v? xmlversion="1.0"encoding="GBK"? > vstream> vstatus>v/status>v! --交易状态char(7)-->vstatusText>v/statusText>v! --交易状态信息varchar(254)-->vlistname="userDataList"> vrow> vbatNo>v/batNo>v! --批次号varchar(8)--> vclientID>v/clientID>v! --客户流水号varchar(20)-->vdebitTotal>v/debitTotal>v! --借记卡总笔数int-->vdebitAmt>v/debitAmt>v! --借记卡总金额decimal(15,2)-->vcreditTotal>v/creditTotal>v! --信用卡总笔数int-->vcreditAmt>v/creditAmt>v! --信用卡总金额decimal(15,2)-->vsuccTotal>v/succTotal>v! --成功总笔数int--> vsuccAmt>v/succAmt>v! --成功总金额decimal(15,2)--> vfailTotalx/failTotalx! --失败总笔数int-->vfailAmtx/failAmtx! --失败总金额decimal(15,2)-->vsttx/stt> --批次受理状态varchar (2),值域见附录4.2--> --充退日期char(8)格式YYYYMMDD--> --充退时间char(6)格式hhmmss--> 3.1.7第三方商户充值退回明细查询 对应请求代码: DL3RTCDT 说明: 查询第三方商户充值回退交易的明细信息 3.1.7.1请求报文 xmlversion="1.0"encoding="GBK"? > vuserNamex/userNamex! -登录名varchar(30)--> --批次号和客户流水号两者必输一项--> vbatNox/batNo> --批次号varchar(8),可空--> --批次号和客户流水号两者必输一项--> v/stream>3.172响应报文 v? xmlversion="1.0"encoding="GBK"? > -交易状态char(7)--> vstatusTextx/statusTextx! --交易状态信息varchar(254)-->vbatNox/batNo> --批次号varchar(8)--> --订单号varchar(20)--> --充退日期char(8)格式YYYYMMDD--> --充退时间char(6)格式hhmmss--> --充退制单号char(20)--> --商户充值退回流水号varchar(20)--> --充退金额decimal(15,2)-->vpayAccNox/payAccNox! --付款账号char(19)-->vabstractx/abstractx! -扌摘要varchar(102)--> --交易状态varchar⑵值域见附录4.3-->vstatusx/statusx! -交易失败状态char⑺--> 3.1.8第三方商户提现经办 对应请求代码: DL3RTXJB说明: 直联用户可以通过本功能实现商户提现信息的经办提交;支持单笔、批量经办提交。 其中输入的收款账号必须为中信16位或19位对私账号;同一批交易中的商户充值退回流水号不能重复。 3.1.8.1请求报文 xmlversion="1.0"encoding="GBK"? > --登录名varchar(30)--> --付款账号char(19)--> --客户流水号varchar(20)--> --商户提现流水号varchar(20)--> --收款账号varchar(19)--> --收款账户名称varchar(122)--> --交易金额decimal(15,2)--> vabstractx/abstractx! -扌摘要varchar(102),可空--> --备注varchar(60),可空--> 3.1.8.2响应报文 xmlversion="1.0"encoding="GBK"? >
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 中信 银行 银企直 联接 口说 电子商务 V5000