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

四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第1页-共19页 四川网通宽带增值业务运营支撑系四川网通宽带增值业务运营支撑系 统统SPSP接口技术规范接口技术规范（试行）（试行） 中国网络通信集团公司中国网络通信集团公司 四川省分公司四川省分公司 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第2页-共19页 目目 录录 1规范说明规范说明.3 2接口规范接口规范.4 2.1BSSP请求查询接口请求查询接口.5 2.2BSSP请求扣费接口请求扣费接口.6 2.3BSSP请求短信接口请求短信接口.9 2.4BSSP接口在线帮助接口在线帮助.10 3开发流程开发流程.11 3.1SP网通开户网通开户.11 3.2SP登陆自服务登陆自服务.12 4消费流程消费流程.13 4.1SP业务首面业务首面.13 4.2业务详细信息业务详细信息.15 5示例代码示例代码.17 5.1SP_ASP代码代码.17 5.2SP_JSP代码代码.17 6联系我们联系我们.18 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第3页-共19页 1 规范说明规范说明 四川网通宽带增值业务运营支撑系统”是一套为营运服务的系统。能够在一个统一的平 台上管理使用各种增值服务的用户； 能够允许用户使用多种系统支持的支付手段进行费用支付，就是将电信提供的各种成 熟的业务支付方式（例如：固话、大灵通等挂账支付、接入用户的接入费用汇总支付等） 引入收费内容服务的支付中，从而为使用任何本平台的收费增值服务的用户提供方便、统 一的支付手段，帮助用户更好的进行业务消费。能够将其他电信系统的用户平滑的引入到 本平台的各种增值服务的消费中； 能够在一个平台上对SP提供的各种增值服务进行统一的业务登记和管理，但又不影响 该SP业务系统的业务灵活性；能够让各种类型、各种成熟度的增值服务在平台的支持下开 展内容提供服务，实现运营和收益； 四川网通宽带增值业务运营支撑系统为各个SP(服务提供商)提供的用于计费扣费的接 口（web service），以帮助sp实现SP服务器接入BSSP系统实现计费，代收费等各种功能。 SP 根据接口规范开发相关页面。SP提供的业务消费的URL必须是在这个域下， 否则无法SSO单点认证。 您需要开发的达到如下要求即可： 可以得到web service返回的xml，并解析该xml得到返回的结果，并根据结果来确定用 户是否可以消费SP提供的服务（成功还是失败，失败的原因等）。 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第4页-共19页 2接口规范接口规范 URL地址为：43/NetCenter/BsspService.asmx 提供SP的web service接口包括： 查询接口（Query） 扣费接口（Pay） 短信接口（SendSMS） 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第5页-共19页 2.1 BSSP 请求查询接口请求查询接口 1)1) 功能说明功能说明 用户访问SP，SP和控件交互有合法的全网SSO标识，用户要求查询到当前帐号余额 情况。BSSP收到该查询请求以后，要求用户提交帐号类型和用户帐号，BSSP进行查询。 BSSP将向用户返回当前余额，确定是否可以进行消费。 2) 请求消息定义请求消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为： 43/NetCenter/BsspService.asmx?op=Query 表表2-2-1 POST表单参数表：表单参数表： 参数名参数值 SPTokenRequestSPTokenRequestValue SPTokenRequestValue包含如下信息： 表表2-2-2 SPTokenRequestValue接口参数接口参数 名称名称标记标记类型类型长度（字节）长度（字节）说明说明 帐号类型AccountTypetinyint12:橙卡；4:固定电话；5:大 灵通；6:宽带帐号；7:窄带 帐号；8:LAN 帐号;其它值 为平台注册帐号 用户帐号UserAccountvarchar40 平台用户帐号，网通小灵 通号，网通宽带帐号 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第6页-共19页 3) 响应消息定义响应消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为： 43/NetCenter/BsspService.asmx?op=Query 表表2-2-3 POST表单参数表：表单参数表： 参数名参数值 SourceBSSP SPTokenResponseSPTokenResponseValue 其中，ReturnURL从SPTokenRequest中获得。 SPTokenResponseValue为接口参数，包含如下信息： 表表2-2-4 SPTokenResponseValue接口参数接口参数 名称名称标记标记类型类型长度（字节）长度（字节）说明说明 返回代码ResultInt4 当该字段0 查询成功 返回用户 属性 MaxMoneynumeric(10,2)后付费用户本月还可继续 消费的最大金额，预付费 用户为当前余额（单位： 元） 当前积分CurrentScoreInt4返回用户当前积分，这一 个字段保留来做扩展用 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第7页-共19页 2.2 BSSP 请求扣费接口请求扣费接口 1)1) 功能说明功能说明 用户访问SP，SP和控件交互有合法的全网SSO标识，用户查询到当前帐号余额情况, 确定要进行消费。BSSP收到该支付请求以后，对用户全网SSO标识验证合法后进行扣费， 扣费成功后允许用户消费该产品，BSSP也记录下该用户的消费SP服务的详细消费清单。 2) 请求消息定义请求消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为：43/NetCenter/BsspService.asmx?op=Pay 表表2-3-1 POST表单参数表：表单参数表： 参数名参数值 SPTokenRequestSPTokenRequestValue SPTokenRequestValue包含如下信息： 表表2-3-2 SPTokenRequestValue接口参数接口参数 名称名称标记标记类型类型长度（字节）长度（字节）说明说明 帐号类型AccountTypetinyint12:橙卡；4:固定电话；5:大灵通； 6:宽带帐号；7:窄带帐号； 8:LAN 帐号;其它值为平台注册 帐号 （注：从 COOKIES 取得） 用户帐号PayAccountvarchar40 平台用户帐号，网通小灵通号， 网通宽带帐号 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第8页-共19页 （注：从 COOKIES 取得） 用户密码AccountPwdvarchar40 平台用户密码，网通小灵通密 码，网通宽带帐号密码，（如 果是网通小灵通，密码为用户 输入的 4 位随机验证码） （注：从 COOKIES 取得） 服务编号ServiceIdvarchar32 由 SP 登陆 BSSP 自服务申请 业务，BSSP 审批通过后，SP 在自服务里查到的服务编号 消费数量UsedAmountInt4 消费 SP 提供的服务数量，即 SP 提供的服务数量，默认为 1 消费金额UsedMoneynumeric(10,2) 服务对应的资费费率（单位： 元） 注：自计费时为页面传入，代 计费时为相应资费费率 用户 IPUserIpvarchar15用户当前本地机子的 IP 消费描述UseMemovarchar200 SP 对提供的服务给出的描述， 对服务的一些申明等 3) 响应消息定义响应消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为：43/NetCenter/BsspService.asmx?op=Pay 表表2-3-3 POST表单参数表：表单参数表： 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第9页-共19页 参数名参数值 SourceBSSP SPTokenResponseSPTokenResponseValue 其中，ReturnURL从SPTokenRequest中获得。 SPTokenResponseValue为接口参数，包含如下信息： 表表2-3-4 SPTokenResponseValue接口参数接口参数 名称名称标记标记类型类型长度（字节）长度（字节）说明说明 返回代码ResultInt4 当该字段0 时表示扣费成功 错误描述ErrStrvarchar200返回扣费失败的原因描述 2.3 BSSP 请求短信接口请求短信接口 1)1) 功能说明功能说明 大灵通用户访问SP，SP和控件交互有合法的全网SSO标识，用户在消费SP服务时， 需要通过接受网通发送的随机验证码验证。要求用户提交用户大灵通号，内容和类型 ID，BSSP执行发送随机码。用户接收到随机码后，填入指定的验证区。 2) 请求消息定义请求消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为：43/NetCenter/BsspService.asmx?op=SendSMS 表表2-5-1 POST表单参数表：表单参数表： 参数名参数值 SPTokenRequestSPTokenRequestValue 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第10页-共19页 SPTokenRequestValue包含如下信息： 表表2-5-2 SPTokenRequestValue接口参数接口参数 名称名称标记标记类型类型长度（字节）长度（字节）说明说明 大灵通号Phonevarchar40用户消费的大灵通号码 内容Contentvarchar40 SP 提供的内容（内容为随意 字符串） 类型 IDIdint4 0：传入内容（留待扩展用） 1：自动发送 4 位随机码 3) 响应消息定义响应消息定义 接口采用重定向POST表单方式。 POST /NetCenter/BsspService.asmx HTTP/1.1 Host: 43 POST目的地址为：43/NetCenter/BsspService.asmx?op= SendSMS 表表2-5-3 POST表单参数表：表单参数表： 参数名参数值 SourceBSSP SPTokenResponseSPTokenResponseValue 其中，ReturnURL从SPTokenRequest中获得。 SPTokenResponseValue为接口参数，包含如下信息： 表表2-5-4 SPTokenResponseValue接口参数接口参数 名称名称标记标记类型类型长度（字节）长度（字节）说明说明 返回代码ResultInt40 则表示失败；1 成功 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第11页-共19页 2.4 BSSP 接口在线帮助接口在线帮助 SP在开发个过程中，如果对web service的具体参数有疑问，可以在参考BSSP提供的 在线帮助。在这里实现为SP代收费，仅提供三个接口（Query、Pay和SendSMS）。 地址为：43/NetCenter/BsspService.asmx 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第12页-共19页 3 开发流程开发流程 3.1 SP 网通开户网通开户 图3-1 SP产品销售及调用接口 先在网通开户（与网通沟通，洽谈相关业务），SP遵循四川网通宽带增值业务运营支 撑系统SP使用协议，中国网通SP合作管理规范。根据上图的流程开发SP服务器接口接入 页面（具体到的接口参数见上接口规范）。 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第13页-共19页 3.2 SP 登陆自服务登陆自服务 图图3-2-1 SP登录自服务登录自服务 SP登陆四川网通宽带增值业务运营支撑系统SP自服务，修改SP基本资料；进行 业务申请，查询SP使用协议，查询服务编号。注：服务地址务必填写正确。 新申请的业务和资费必须提交四川网通审核，审核通过才可以用于向用户提供服 务，其中的资费一经审核通过，如需改动也必须提交四川网通审核（防止随意改 动资费费率），审核通过才对业务提供的资费生效，完成资费变动。 服务器IP必须是SP服务器当前调用web service的服务器IP（对调用接口的服务器 IP要进行验证）。 地址为： 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第14页-共19页 4消费流程消费流程 图图4-1 用户的消费物理流程用户的消费物理流程 上图描述了一个用户消费的物理流程：用户通过访问SP服务器浏览SP提供的服务，决 定要消费该项服务时，在SP服务页面上提交全网SSO标识，就重定向到BSSP请求认证授 权。用户提交帐号密码，BSSP进行认证。用户认证通过以后，返回用户是否可以消费该 项服务，SP做出相应的流程处理。 注：用户必须通过登陆BSSP系统才可以取得全网SSO认证，写入本地 COOKIE（auth_login ，auth_pwd ，AccountType） URL： 4.1 SP 业务首面业务首面 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第15页-共19页 图图4-1-1 SP提供的业务首页提供的业务首页 点击后，出现用户将要消费的产品的各种信息： 例如：您销售的是卡，就把卡的各种信息罗列出来：到期时间、面额、谁发行的、使 用范围等；若是电影：电影简介，电影时长，电影片名等。 注：用户点击消费时，同时检查用户是否登陆过BSSP系统，当没有登陆：自动跳转到 （当超链接过来带参数 serviceId 时可以实现用户 登录完自动跳转到SP服务URL地址，用户可继续在SP站点消费业务）提示用户登录，用户 登录完后就进入下面的流程；当已经登陆：进入下面的流程。 四川网通宽带增值业务运营支撑系统 SP 接口技术规范 中国网络通信集团公司四川省分公司 第16页-共19页 4.2 业务详细信息业务详细信息 图图4-2