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 客户产品计费标识 产品查询密码（可为空） 客户地区 客户标识 客户帐号 注释