北京银行银企直联交易接口详细说明文档20220412.docVIP

北京商业银行银企互联接口数据详细说明 PAGE PAGE 91 易诚世纪版权所有 DATE \@ yyyy-M-d 2022-11-25 北京银行银企直联接口 详细说明 前言 本文档主要描述银企直联系统对外提供接口格式及各个数据域的具体约定进行详细说明。 企业互联双方HTTP通讯协定 1.1 HTTP数据协定 银企互联企业端和网银服务器端采用HTTP协议进行通讯。 为区分银企互联渠道接入的用户，需要银企互联企业端，在发送请求数据时，必须将HTTP属性域中的“User-Agent”设置为“API”。 以下将交易上传HTTP请求的不同，区分为三种交易。 1.1.1 登录交易 企业应用端请求HTTP数据： 数据以HTTP Form的格式发送，所有数据均需要采用URL Encode 编码，包含如下Form 数据： netType： 应用类型，应用类型需要在Session管理系统中分配。(上传“3”) reqData： 交易请求XML报文 请求URL为： /servlet/com.bccb.inbs.api.servlet. APISessionReqServlet? netType=3reqData=******* 客户端调用com.bccb.inbs.api.servlet. APISessionReqServlet作为交易入口； 并传递相关交易必须参数： 其中netType为银企互联用户固定上传为“3”； 其它数据为交易特殊数据。 服务器端响应数据： dse_sessionId+ “|” + 交易返回XML包 1.1.2 一般交易请求 企业应用端请求数据： 数据以HTTP Form的格式发送，所有数据均需要采用URL Encode 编码，包含如下Form 数据： dse_sessionId：在登录时得到的，每次交易必须上传。 opName：交易名称。每个交易按照约定，具有唯一性。 reqData：交易请求XML报文 请求URL为： /servlet/com.bccb.inbs.api.servlet. APIReqServlet? dse_sessionId=****** opName =****** reqData=******* 客户端调用com.bccb.inbs.api.servlet. APIReqServlet作为交易入口； 并传递相关交易必须6个参数即可。 服务器端响应数据： 交易响应XML报文，数据不作任何编码。 1.1.3 签退交易 企业应用端请求数据： 数据以HTTP Form的格式发送，所有数据均需要采用URL Encode 编码，包含如下Form 数据： dse_sessionId：在登录时得到的 请求URL为： /servlet/com.bccb.inbs.api.servlet. APISignOffReqServlet? dse_sessionId=****** 客户端调用com.bccb.inbs.api.servlet. APISignOffReqServlet作为交易入口； 并传递相关交易必须参数dse_sessionId即可。 服务器端响应数据： 无 1.2 银企互联相关交易XML格式约定 银企互联信息交换格式采用XML数据包的格式。数据包采用只规定主体格式的方式，每个主体的具体内容可以根据具体的交易内容变化。 1.2.1 XML交易包概述 请求包格式 格式示例： ?xml version=1.0 encoding = GB2312? BCCBEBankData opReq !-- 交易请求数据 -- opNameAccountDetailQuery/opName!-- 交易名称-- serialNo1235454/serialNo !-- 交易序列号(客户端唯一标识) -- reqTimreqTime !-- 客户端请求时间 -- ReqParam !-- 交易请求参数实体，里面的具体参数可以添加 -- …… /ReqParam /opReq /BCCBEBankData 请求包说明： BCCBEBankData：此TAG用于标识为北京商行银企互联数据格式包 请求包从opReq开始。有三个必输项： 包括opName交易名称/opName：表示需要执行的WSBCC