四川网通宽带增值业务运营支撑系统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