四川网通宽带增值业务运营支撑系统SP接口技术规范.doc

四川网通宽带增值业务运营支撑系统SP接口技术规范 中国网络通信集团公司四川省分公司 第 PAGE 7页-共 NUMPAGES 18页 四川网通宽带增值业务运营支撑系统SP接口技术规范（试行） 中国网络通信集团公司 四川省分公司 目 录 TOC \o 1-3 \h \z \u 1 规范说明 3 2 接口规范 4 2.1 BSSP请求查询接口 5 2.2 BSSP请求扣费接口 6 2.3 BSSP请求短信接口 9 2.4 BSSP接口在线帮助 10 3 开发流程 11 3.1 SP网通开户 11 3.2 SP登陆自服务 12 4 消费流程 13 4.1 SP业务首面 13 4.2 业务详细信息 15 5 示例代码 17 5.1 SP_ASP代码 17 5.2 SP_JSP代码 17 6 联系我们 18  规范说明 四川网通宽带增值业务运营支撑系统”是一套为营运服务的系统。能够在一个统一的平台上管理使用各种增值服务的用户； 能够允许用户使用多种系统支持的支付手段进行费用支付，就是将电信提供的各种成熟的业务支付方式（例如：固话、大灵通等挂账支付、接入用户的接入费用汇总支付等）引入收费内容服务的支付中，从而为使用任何本平台的收费增值服务的用户提供方便、统一的支付手段，帮助用户更好的进行业务消费。能够将其他电信系统的用户平滑的引入到本平台的各种增值服务的消费中； 能够在一个平台上对SP提供的各种增值服务进行统一的业务登记和管理，但又不影响该SP业务系统的业务灵活性；能够让各种类型、各种成熟度的增值服务在平台的支持下开展内容提供服务，实现运营和收益； 四川网通宽带增值业务运营支撑系统为各个SP(服务提供商)提供的用于计费扣费的接口（web service），以帮助sp实现SP服务器接入BSSP系统实现计费，代收费等各种功能。SP 根据接口规范开发相关页面。SP提供的业务消费的URL必须是在169这个域下，否则无法SSO单点认证。 您需要开发的达到如下要求即可： 可以得到web service返回的xml，并解析该xml得到返回的结果，并根据结果来确定用户是否可以消费SP提供的服务（成功还是失败，失败的原因等）。  接口规范 URL地址为： 43/NetCenter/BsspService.asmx 提供SP的web service接口包括： HYPERLINK 查询接口（Query） HYPERLINK 扣费接口（Pay） HYPERLINK 短信接口（SendSMS） BSSP请求查询接口 功能说明 用户访问SP，SP和控件交互有合法的全网SSO标识，用户要求查询到当前帐号余额情况。BSSP收到该查询请求以后，要求用户提交帐号类型和用户帐号，BSSP进行查询。BSSP将向用户返回当前余额，确定是否可以进行消费。 请求消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为： 43/NetCenter/BsspService.asmx?op=Query 表2-2-1 POST表单参数表： 参数名 参数值 SPTokenRequest SPTokenRequestValue SPTokenRequestValue包含如下信息： 表2-2-2 SPTokenRequestValue接口参数 名称 标记 类型 长度（字节） 说明 帐号类型 AccountType tinyint 1 2:橙卡；4:固定电话；5:大灵通；6:宽带帐号；7:窄带帐号；8:LAN帐号;其它值为平台注册帐号 用户帐号 UserAccount varchar 40 平台用户帐号，网通小灵通号，网通宽带帐号 响应消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为： 43/NetCenter/BsspService.asmx?op=Query 表2-2-3 POST表单参数表： 参数名 参数值 Source BSSP SPTokenResponse SPTokenResponseValue 其中，ReturnURL从SPTokenRequest中获得。 SPTokenResponseValue为接口参数，包含如下信息： 表2-2-4 SPTokenResponseValue接口参数 名称 标记 类型 长度（字节） 说明 返回代码 Result Int 4 当该字段0则表示认证失败；0查询成功 返回用户属性 MaxMoney numer