四川网通宽带增值业务运营支撑系统SP接口技术规范.doc
- 文档编号:7430942
- 上传时间:2023-05-11
- 格式:DOC
- 页数:18
- 大小:821KB
四川网通宽带增值业务运营支撑系统SP接口技术规范.doc
《四川网通宽带增值业务运营支撑系统SP接口技术规范.doc》由会员分享,可在线阅读,更多相关《四川网通宽带增值业务运营支撑系统SP接口技术规范.doc(18页珍藏版)》请在冰点文库上搜索。
四川网通宽带增值业务运营支撑系统SP接口技术规范
四川网通宽带增值业务运营支撑系统SP接口技术规范(试行)
中国网络通信集团公司
四川省分公司
目录
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
1规范说明
四川网通宽带增值业务运营支撑系统”是一套为营运服务的系统。
能够在一个统一的平台上管理使用各种增值服务的用户;
能够允许用户使用多种系统支持的支付手段进行费用支付,就是将电信提供的各种成熟的业务支付方式(例如:
固话、大灵通等挂账支付、接入用户的接入费用汇总支付等)引入收费内容服务的支付中,从而为使用任何本平台的收费增值服务的用户提供方便、统一的支付手段,帮助用户更好的进行业务消费。
能够将其他电信系统的用户平滑的引入到本平台的各种增值服务的消费中;
能够在一个平台上对SP提供的各种增值服务进行统一的业务登记和管理,但又不影响该SP业务系统的业务灵活性;能够让各种类型、各种成熟度的增值服务在平台的支持下开展内容提供服务,实现运营和收益;
四川网通宽带增值业务运营支撑系统为各个SP(服务提供商)提供的用于计费扣费的接口(webservice),以帮助sp实现SP服务器接入BSSP系统实现计费,代收费等各种功能。
SP根据接口规范开发相关页面。
SP提供的业务消费的URL必须是在这个域下,否则无法SSO单点认证。
您需要开发的达到如下要求即可:
可以得到webservice返回的xml,并解析该xml得到返回的结果,并根据结果来确定用户是否可以消费SP提供的服务(成功还是失败,失败的原因等)。
2接口规范
URL地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx
提供SP的webservice接口包括:
l查询接口(Query)
l扣费接口(Pay)
l短信接口(SendSMS)
2.1BSSP请求查询接口
1)功能说明
用户访问SP,SP和控件交互有合法的全网SSO标识,用户要求查询到当前帐号余额情况。
BSSP收到该查询请求以后,要求用户提交帐号类型和用户帐号,BSSP进行查询。
BSSP将向用户返回当前余额,确定是否可以进行消费。
2)请求消息定义
接口采用重定向POST表单方式。
POST/NetCenter/BsspService.asmxHTTP/1.1
Host:
221.10.251.243
POST目的地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx?
op=Query
表2-2-1POST表单参数表:
参数名
参数值
SPTokenRequest
SPTokenRequestValue
SPTokenRequestValue包含如下信息:
表2-2-2SPTokenRequestValue接口参数
名称
标记
类型
长度(字节)
说明
帐号类型
AccountType
tinyint
1
2:
橙卡;4:
固定电话;5:
大灵通;6:
宽带帐号;7:
窄带帐号;8:
LAN帐号;其它值为平台注册帐号
用户帐号
UserAccount
varchar
40
平台用户帐号,网通小灵通号,网通宽带帐号
3)响应消息定义
接口采用重定向POST表单方式。
POST/NetCenter/BsspService.asmxHTTP/1.1
Host:
221.10.251.243
POST目的地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx?
op=Query
表2-2-3POST表单参数表:
参数名
参数值
Source
BSSP
SPTokenResponse
SPTokenResponseValue
其中,ReturnURL从SPTokenRequest中获得。
SPTokenResponseValue为接口参数,包含如下信息:
表2-2-4SPTokenResponseValue接口参数
名称
标记
类型
长度(字节)
说明
返回代码
Result
Int
4
当该字段<0则表示认证失败;>0查询成功
返回用户属性
MaxMoney
numeric
(10,2)
后付费用户本月还可继续消费的最大金额,预付费用户为当前余额(单位:
元)
当前积分
CurrentScore
Int
4
返回用户当前积分,这一个字段保留来做扩展用
2.2BSSP请求扣费接口
1)功能说明
用户访问SP,SP和控件交互有合法的全网SSO标识,用户查询到当前帐号余额情况,确定要进行消费。
BSSP收到该支付请求以后,对用户全网SSO标识验证合法后进行扣费,扣费成功后允许用户消费该产品,BSSP也记录下该用户的消费SP服务的详细消费清单。
2)请求消息定义
接口采用重定向POST表单方式。
POST/NetCenter/BsspService.asmxHTTP/1.1
Host:
221.10.251.243
POST目的地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx?
op=Pay
表2-3-1POST表单参数表:
参数名
参数值
SPTokenRequest
SPTokenRequestValue
SPTokenRequestValue包含如下信息:
表2-3-2SPTokenRequestValue接口参数
名称
标记
类型
长度(字节)
说明
帐号类型
AccountType
tinyint
1
2:
橙卡;4:
固定电话;5:
大灵通;6:
宽带帐号;7:
窄带帐号;8:
LAN帐号;其它值为平台注册帐号
(注:
从COOKIES取得)
用户帐号
PayAccount
varchar
40
平台用户帐号,网通小灵通号,网通宽带帐号
(注:
从COOKIES取得)
用户密码
AccountPwd
varchar
40
平台用户密码,网通小灵通密码,网通宽带帐号密码,(如果是网通小灵通,密码为用户输入的4位随机验证码)
(注:
从COOKIES取得)
服务编号
ServiceId
varchar
32
由SP登陆BSSP自服务申请业务,BSSP审批通过后,SP在自服务里查到的服务编号
消费数量
UsedAmount
Int
4
消费SP提供的服务数量,即SP提供的服务数量,默认为1
消费金额
UsedMoney
numeric
(10,2)
服务对应的资费费率(单位:
元)
注:
自计费时为页面传入,代计费时为相应资费费率
用户IP
UserIp
varchar
15
用户当前本地机子的IP
消费描述
UseMemo
varchar
200
SP对提供的服务给出的描述,对服务的一些申明等
3)响应消息定义
接口采用重定向POST表单方式。
POST/NetCenter/BsspService.asmxHTTP/1.1
Host:
221.10.251.243
POST目的地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx?
op=Pay
表2-3-3POST表单参数表:
参数名
参数值
Source
BSSP
SPTokenResponse
SPTokenResponseValue
其中,ReturnURL从SPTokenRequest中获得。
SPTokenResponseValue为接口参数,包含如下信息:
表2-3-4SPTokenResponseValue接口参数
名称
标记
类型
长度(字节)
说明
返回代码
Result
Int
4
当该字段<0时表示扣费失败;>0时表示扣费成功
错误描述
ErrStr
varchar
200
返回扣费失败的原因描述
2.3BSSP请求短信接口
1)功能说明
大灵通用户访问SP,SP和控件交互有合法的全网SSO标识,用户在消费SP服务时,需要通过接受网通发送的随机验证码验证。
要求用户提交用户大灵通号,内容和类型ID,BSSP执行发送随机码。
用户接收到随机码后,填入指定的验证区。
2)请求消息定义
接口采用重定向POST表单方式。
POST/NetCenter/BsspService.asmxHTTP/1.1
Host:
221.10.251.243
POST目的地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx?
op=SendSMS
表2-5-1POST表单参数表:
参数名
参数值
SPTokenRequest
SPTokenRequestValue
SPTokenRequestValue包含如下信息:
表2-5-2SPTokenRequestValue接口参数
名称
标记
类型
长度(字节)
说明
大灵通号
Phone
varchar
40
用户消费的大灵通号码
内容
Content
varchar
40
SP提供的内容(内容为随意字符串)
类型ID
Id
int
4
0:
传入内容(留待扩展用)
1:
自动发送4位随机码
3)响应消息定义
接口采用重定向POST表单方式。
POST/NetCenter/BsspService.asmxHTTP/1.1
Host:
221.10.251.243
POST目的地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx?
op=SendSMS
表2-5-3POST表单参数表:
参数名
参数值
Source
BSSP
SPTokenResponse
SPTokenResponseValue
其中,ReturnURL从SPTokenRequest中获得。
SPTokenResponseValue为接口参数,包含如下信息:
表2-5-4SPTokenResponseValue接口参数
名称
标记
类型
长度(字节)
说明
返回代码
Result
Int
4
0则表示失败;1成功
2.4BSSP接口在线帮助
SP在开发个过程中,如果对webservice的具体参数有疑问,可以在参考BSSP提供的在线帮助。
在这里实现为SP代收费,仅提供三个接口(Query、Pay和SendSMS)。
地址为:
http:
//221.10.251.243/NetCenter/BsspService.asmx
3开发流程
3.1SP网通开户
图3-1SP产品销售及调用接口
先在网通开户(与网通沟通,洽谈相关业务),SP遵循四川网通宽带增值业务运营支撑系统SP使用协议,中国网通SP合作管理规范。
根据上图的流程开发SP服务器接口接入页面(具体到的接口参数见上接口规范)。
3.2SP登陆自服务
图3-2-1SP登录自服务
SP登陆四川网通宽带增值业务运营支撑系统SP自服务,修改SP基本资料;进行业务申请,查询SP使用协议,查询服务编号。
注:
服务地址务必填写正确。
新申请的业务和资费必须提交四川网通审核,审核通过才可以用于向用户提供服务,其中的资费一经审核通过,如需改动也必须提交四川网通审核(防止SP随意改动资费费率),审核通过才对业务提供的资费生效,完成资费变动。
服务器IP必须是SP服务器当前调用webservice的服务器IP(对调用接口的服务器IP要进行验证)。
地址为:
4消费流程
图4-1用户的消费物理流程
上图描述了一个用户消费的物理流程:
用户通过访问SP服务器浏览SP提供的服务,决定要消费该项服务时,在SP服务页面上提交全网SSO标识,就重定向到BSSP请求认证授权。
用户提交帐号密码,BSSP进行认证。
用户认证通过以后,返回用户是否可以消费该项服务,SP做出相应的流程处理。
注:
用户必须通过登陆BSSP系统才可以取得全网SSO认证,写入本地COOKIE(auth_login,auth_pwd,AccountType)
URL:
4.1SP业务首面
图4-1-1SP提供的业务首页
点击后,出现用户将要消费的产品的各种信息:
例如:
您销售的是卡,就把卡的各种信息罗列出来:
到期时间、面额、谁发行的、使用范围等;若是电影:
电影简介,电影时长,电影片名等。
注:
用户点击消费时,同时检查用户是否登陆过BSSP系统,当没有登陆:
自动跳转到(当超链接过来带参数serviceId时可以实现用户登录完自动跳转到SP服务URL地址,用户可继续在SP站点消费业务)提示用户登录,用户登录完后就进入下面的流程;当已经登陆:
进入下面的流程。
4.2业务详细信息
图4-2-1业务详细信息
点击“播放影片”后,也就是经过用户确认后,下一个页面就是调用我们的接口webservice
l当用户为非大灵通用户,则执行扣费动作,扣费成功后,您为用户提供服务(例如,卡就显示卡号,密码等卡信息,电影就播放给用户看)。
l当用户为大灵通用户,则进入大灵通消费页面,要求用户在每次消费前都要经过短息验证。
图4-2-2大灵通用户消费页面
点击警告的确定按钮进入下面的页面
图4-2-3输入随机验证码
填入用户接收到的随机验证码,提交后SP就调用扣费接口,则执行扣费动作,扣费成功后,您为用户提供服务(例如,卡就显示卡号,密码等卡信息,电影就播放给用户看)。
5示例代码
5.1SP_ASP代码
SP登陆四川网通宽带增值业务运营支撑系统SP自服务,SP开发向导里查询SP使用协议,SP_ASP示例代码下载,代码仅供参考。
登录地址为:
5.2SP_JSP代码
SP登陆四川网通宽带增值业务运营支撑系统SP自服务,SP开发向导里查询SP使用协议,SP_JSP示例代码下载。
代码仅供参考。
登录地址为:
6联系我们
SP在开发个过程中,如果对webservice的具体参数有疑问或者不清楚的问题。
请咨询:
13398152090、028-66322231、028-66938027
中国网络通信集团公司四川省分公司
第18页-共18页
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- 四川 网通 宽带 增值 业务 运营 支撑 系统 SP 接口 技术规范