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

1、5.2SP_JSP代码176联系我们181 规范说明四川网通宽带增值业务运营支撑系统”是一套为营运服务的系统。能够在一个统一的平台上管理使用各种增值服务的用户；能够允许用户使用多种系统支持的支付手段进行费用支付，就是将电信提供的各种成熟的业务支付方式（例如：固话、大灵通等挂账支付、接入用户的接入费用汇总支付等）引入收费内容服务的支付中，从而为使用任何本平台的收费增值服务的用户提供方便、统一的支付手段，帮助用户更好的进行业务消费。能够将其他电信系统的用户平滑的引入到本平台的各种增值服务的消费中；能够在一个平台上对SP提供的各种增值服务进行统一的业务登记和管理，但又不影响该SP业务系统的业务灵活性

2、；能够让各种类型、各种成熟度的增值服务在平台的支持下开展内容提供服务，实现运营和收益；四川网通宽带增值业务运营支撑系统为各个SP（服务提供商）提供的用于计费扣费的接口（web service），以帮助sp实现SP服务器接入BSSP系统实现计费，代收费等各种功能。SP 根据接口规范开发相关页面。SP提供的业务消费的URL必须是在这个域下，否则无法SSO单点认证。您需要开发的达到如下要求即可：可以得到web service返回的xml，并解析该xml得到返回的结果，并根据结果来确定用户是否可以消费SP提供的服务（成功还是失败，失败的原因等）。 2 接口规范URL地址为：http:/221.10.2

3、51.243/NetCenter/BsspService.asmx提供SP的web service接口包括：l 查询接口（Query）l 扣费接口（Pay）l 短信接口（SendSMS）2.1 BSSP请求查询接口1） 功能说明用户访问SP，SP和控件交互有合法的全网SSO标识，用户要求查询到当前帐号余额情况。BSSP收到该查询请求以后，要求用户提交帐号类型和用户帐号，BSSP进行查询。BSSP将向用户返回当前余额，确定是否可以进行消费。2） 请求消息定义接口采用重定向POST表单方式。POST /NetCenter/BsspService.asmx HTTP/1.1Host: 221.10.

4、251.243POST目的地址为：/221.10.251.243/NetCenter/BsspService.asmx?op=Query表2-2-1 POST表单参数表：参数名参数值SPTokenRequestSPTokenRequestValueSPTokenRequestValue包含如下信息：表2-2-2 SPTokenRequestValue接口参数名称标记类型长度（字节）说明帐号类型AccountTypetinyint12:橙卡；4:固定电话；5:大灵通；6:宽带帐号；7:窄带帐号；8:LAN帐号;其它值为平台注册帐号用户帐号UserAccountvarchar40平台用户帐号，网通

5、小灵通号，网通宽带帐号3） 响应消息定义表2-2-3 POST表单参数表：SourceBSSPSPTokenResponseSPTokenResponseValue其中，ReturnURL从SPTokenRequest中获得。SPTokenResponseValue为接口参数，包含如下信息：表2-2-4 SPTokenResponseValue接口参数返回代码ResultInt4当该字段0查询成功 返回用户属性MaxMoneynumeric（10,2）后付费用户本月还可继续消费的最大金额，预付费用户为当前余额（单位：元）当前积分CurrentScore返回用户当前积分，这一个字段保留来做扩展用

6、2.2 BSSP请求扣费接口用户访问SP，SP和控件交互有合法的全网SSO标识，用户查询到当前帐号余额情况, 确定要进行消费。BSSP收到该支付请求以后，对用户全网SSO标识验证合法后进行扣费，扣费成功后允许用户消费该产品，BSSP也记录下该用户的消费SP服务的详细消费清单。op=Pay表2-3-1 POST表单参数表：表2-3-2 SPTokenRequestValue接口参数（注：从COOKIES取得）PayAccount用户密码AccountPwd平台用户密码，网通小灵通密码，网通宽带帐号密码，（如果是网通小灵通，密码为用户输入的4位随机验证码）服务编号ServiceId32由SP登陆B

7、SSP自服务申请业务，BSSP审批通过后，SP在自服务里查到的服务编号消费数量UsedAmount消费SP提供的服务数量，即SP提供的服务数量，默认为1消费金额UsedMoney服务对应的资费费率（单位：注：自计费时为页面传入，代计费时为相应资费费率用户IPUserIp15用户当前本地机子的IP消费描述UseMemo200SP对提供的服务给出的描述，对服务的一些申明等表2-3-3 POST表单参数表：表2-3-4 SPTokenResponseValue接口参数0时表示扣费失败；0时表示扣费成功错误描述ErrStr返回扣费失败的原因描述2.3 BSSP请求短信接口大灵通用户访问SP，SP和控件

8、交互有合法的全网SSO标识，用户在消费SP服务时，需要通过接受网通发送的随机验证码验证。要求用户提交用户大灵通号，内容和类型ID，BSSP执行发送随机码。用户接收到随机码后，填入指定的验证区。op=SendSMS表2-5-1 POST表单参数表：表2-5-2 SPTokenRequestValue接口参数大灵通号Phone用户消费的大灵通号码内容ContentSP提供的内容（内容为随意字符串）类型IDIdint0：传入内容（留待扩展用）1：自动发送4位随机码op= SendSMS表2-5-3 POST表单参数表：表2-5-4 SPTokenResponseValue接口参数0则表示失败；1成功 2.4 BSSP接口在线帮助SP在开发个过程中，如果对web service的具体参数有疑问，可以在参考BSSP提供的在线帮助。在这里实现为SP代收费，仅提供三个接口（Query、Pay和SendSMS）。地址为：3 开发流程3.1 SP网通开户图3-1 SP产品销售及调用接口先在网通开户（与网通沟通，洽谈相关业务），SP遵循四川网通宽带增值业务运营支撑系统SP使用协议，中国网通SP合作管理规范。根据上图的流程开发SP服务器接口接入页面（具体到的接口参数见上接口规范）。3.2 SP登陆自服务图3