Q/CT XXXX-2014

4.2.10 支付结果通知 4.2.10.1 产品平台

将支付结果告知省领航平台(ISMP-B)管理子系统。 4.2.10.2 省领航平台(ISMP-B)管理子系统

接收支付结果通知，并将处理结果返回给产品平台。

7

Q/CT XXXX-2014

5、 接口定义

注：下列SOAP的超时时间定义为30秒（发起方发起请求开始计时），超过30秒后自动断开连接；http请求的响应时间为60秒；

5.1

SOAP&HTTP方式

省领航平台(ISMP-B)管理子系统与产品平台的业务数据通过省领航平台(ISMP-B)管理子系统提供的WebService服务进行交换。省领航平台(ISMP-B)管理子系统作为服务端，提供TradeService.wsdl文件供SI产品平台引用；产品平台作为客户端，只需提供一个URL地址接受省领航平台(ISMP-B)管理子系统发起的通知消息。具体接口方法及格式定义说明：

1) 省领航平台(ISMP-B)管理子系统提供的wsdl文件地址：

http://services.provinceid.bnet.cn/v3.0/TradeService.wsdl 在TradeService.wsdl中包含的方法有：

public String getPortalRequest(String streamingno,String rand)；//依据流水号以及随机令牌取得交易明文

public String getPortalResult(String reqXML)；//依据XML请求报文取得相应的XML应答报文 public String getEncodeString(String decode)；//依据明文取得相应密文

2) 产品平台提供省领航平台(ISMP-B)管理子系统的URL地址：

http://service.productid.provinceid.bnet.cn 其中productid为产品编号，provinceid为省标识。

在省领航平台(ISMP-B)管理子系统触发调用产品平台提供的HTTP请求时，产品平台URL中包括参数：流水号streamingno、随机令牌rand和密文信息encode。格式如：http://service.productid.provinceid.bnet.cn?streamingno=1111&rand=1234&encode=xxxx。

3) 加密协议

领航平台采用MD5 算法作为系统关键域的加密协议。考虑到各类开发语言基于MD5 算法的实现方面可能存在差异性，为了实现平台整体的开发语言无关性，平台将MD5算法进行了相应封装，并提供相关的WEBSERVICE 服务供外界系统调用（getEncodeString）。 5.1.1 客户开通/变更/退订产品接口 5.1.1.1 接口协议概述

? 接口名称：客户开通/变更/退订产品。

? 接口描述：省领航平台(ISMP-B)管理子系统把客户开通/变更/退订产品的数据信息经过产品接口

同步到产品平台（注：客户产品属性通过客户信息查询接口获取）。个人单订购，客户单订购，双订购的客户订购走此接口。

? 触发条件：省领航平台(ISMP-B)管理子系统向产品平台发送客户开通/变更/退订产品请求时触发

产品平台调用此接口。

? 接口协议：SOAP(Document Style)。

? 接口调用方向：产品平台 ? 省领航平台(ISMP-B)管理子系统。 ? 命名空间：http://www.bnet.cn/v3.0/。

? 接口方法：getPortalRequest、getPortalResult。

5.1.1.2 接口流程

主要涉及到的接口调用流程:

8

Q/CT XXXX-2014

图 1客户开通/变更/退订产品接口流程

1) 客户管理员在集团领航平台管理子系统中客户工作台开通/变更/退订产品；

2) 集团领航平台管理子系统生成相关参数StreamingNo、rand和encode,并存入日志表中；

3) 集团BNET管理子系统调用产品平台提供的HTTP请求，在请求中加入关键字信息，格式如下：

http://service.productid.bnet.cn?StreamingNo=xxxx&rand=xxxx&encode=xxxx。其中StreamingNo为明文数字（其中通过时间戳和4位随机数组合而成），rand为4位随机数字，encode为开户请求数据包通过MD5加密后的字符串；

4) 产品平台从HTTP请求中获取的交易关键字StreamingNo、rand、encode，加入到调用集团BNET管理

子系统的webservice接口方法getPortalRequest中，发起从集团BNET管理子系统获取客户信息的

9

Q/CT XXXX-2014

请求；

5) 集团BNET管理子系统根据收到的接口参数，判断校验通过后，返回产品平台客户数据内容包，并注

销本次交易流水记录；

6) 产品平台根据获取的客户数据内容包，调用getEncodeString加密获取数据包； 7) 集团BNET管理子系统根据产品平台的请求包加密后返回给产品平台； 8) 产品平台获取加密后的数据包与第四步中获取的encode进行验证； 9) 第八步验证通过后，产品平台调用集团BNET管理子系统的webservice接口方法getPortalResult, 发

起从集团BNET管理子系统的查询某一客户信息请求；

10) 集团BNET管理子系统获取产品平台发起请求报文中的查询密码，并与原先在集团BNET管理子系统设

定的产品查询密码进行比较验证；

11) 第十步验证通过后，集团BNET管理子系统返回产品平台客户数据内容包； 12) 产品平台获取客户数据包内容，进行本地的客户信息处理；

13) 产品平台将客户信息处理后的结果返回给集团BNET管理子系统；

14) 集团BNET管理子系统根据产品平台的处理结果进行了相应的客户产品处理；

15) 集团BNET管理子系统处理完成以后，返回给产品平台一个包含重定向地址的数据内容包； 16) 产品平台获取返回的报文，解析出其中的重定向的url，然后重定向操作。 5.1.1.3 数据信息定义

5.1.1.3.1 领航平台返回产品平台要素定义

表 1领航平台返回产品平台要素定义

参数名 StreamingNo OPFlag 类型 String String 出现次数 1 1 长度 32 4 流水号 0101：客户开通 0102：客户变更 0103：客户退订 0107:客户停机 0108:客户复机 0109:改号 TimeStamp ProductID SIID OfferID String String String String 1 1 1 0..1 18 8 20 20 当前时间戳 YYYYMMDDHHMISS 产品标识 SI标识 销售品ID 销售品标识，本期只涉及一个产品包含多个销售品，但一个销售品只对应一个产品 BizID Password AreaCode CustID CustAccount 10

String String String String String 1 1 1 1 1 20 32 5 20 100 客户产品计费标识 产品查询密码（可为空） 客户地区 客户标识 客户帐号 注释