iptv业务管理平台2.0订购接口

《iptv业务管理平台2.0订购接口》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、1.订购及计费接口1.1业务订购/退订购流程STB业务系统业务管理平台1.Http请求3.业务订购请求4.返回订购确认页面2.重定向8.返回处理页面5.确认订购6.返回处理结果7.保存订购信息图4-5-1-1：即时业务订购流程图链接：http://124.75.29.164:7001/iptv3a/user/subscribe/subscribe.do1.1.1接口协议内容承载协议：1.HTTPGET增值业务使用2.SOAPEPG使用接口方向：EPG服务系统重定向–>业务管理平台接口功能:用户订购业务。请求消息包含以下关键参数业务订购请求参数名称说明数据类型长度（字节）是否必选SPIDSP的唯

2、一标识string8MUserIDIPTV用户业务编号string36OContentID内容IDstring32OServiceIDIPTV服务编号string20MProductIDIPTV产品编号string16OUserToken业务管理平台为该用户分配的临时身份证明，可采用Cookie的方式传递string32MReturnURL返回EPG服务页面的URLstring256MAction订购动作1：订购；2：退订Sting1M返回参数名称说明数据类型长度（字节）是否必选Result业务订购结果0：成功其他：失败String4MDescription结果描述String256OUser

3、IDIPTV用户业务编号string36OUserToken业务管理平台为该用户分配的临时身份证明，可采用Cookie的方式传递string32OServiceIDIPTV服务编号string20MProductIDIPTV产品编号string16MProductNameIPTV产品名称string100OPurchaseType0：免费1：按次支付5：包月int4MFee支付金额(以分为单位)int4OSPIDSP的唯一标识string8OTransactionID订购的事务编号string40OExpiredTime订购关系的失效时间，格式为YYYYMMDDhhmmss。缺少该参数表示永久

4、有效。String14O1.1.1订购参数校验要求1.UserToken必须有效，从UserToken可以找到UserID；2.Serviceid和Contentid必须两者存在其一；3.通过UserID，可以从User表得到用户数据，用户状态正常；4.通过ProductID，可以从Product表获得产品数据；5.产品状态为发布状态（status=3）；6.产品应该没有过期，过期时间小于当前时间；7.如果是包月产品，应该至少还有一个月的使用时间，到期时间至少在一个月以后；8.非CRM产品，其授权应该不存在；9.CRM产品在存在有效授权的情况下（ProductAuth表status=1），订购

5、会先作废原有授权，然后继续进行，生成新的授权；10.产品应该存在计费策略；11.产品应该有服务对应关系。1.1.2退订购参数校验要求1.UserToken必须有效，从UserToken可以找到UserID；2.Serviceid和Contentid必须两者存在其一；3.通过UserID，可以从User表得到用户数据，用户状态正常；4.通过ProductID，可以从Product表获得产品数据；5.产品状态为发布状态（status=3）；6.产品必须是包月产品，按次和免费产品均不可以退订购；7.必须是有效授权，授权状态不能为过期（ProductAuth表status!=9）；8.如果产品的授权还

6、在免费期内，不可以退订购；9.产品应该存在计费策略；10.产品应该有服务对应关系；11.如果是CRM产品，必须30天以后才可以退订购。1.1.1订购/退订购接口SOAP方式和HTTP方式异同由于EPG订购采用SOAP方式，而增值业务订购采用HTTP方式，所以处理有所不同。1.EPG处理请求与确认页面，具体说为：EPG订购由EPG负责订购请求页面，该页面直接通过服务鉴权接口，获得可以订购的产品列表，列表中已经包含产品价格及优惠内容等信息；IPTV3A平台判定是否可以订购/退订购，然后执行订购/退订购动作。2.增值业务管理平台处理请求页面，确认页面由IPTV3A平台提供。增值业务平台没有实现单个增

7、值业务业务鉴权接口，所以不会获得产品价格和优惠信息；订购的时候，由增值业务平台发起请求，IPTV3A平台生成确认页面，给用户说明产品，并列出优惠信息。1.1.2错误代码表分类代码描述全部0成功订购关系1001该产品已经存在有效授权　1002生成产品授权错　1003产品授权无法插入数据库　1005无有效产品授权　1004终止授权关系出错　1006无法执行完成退订购　1007无法执行完成暂停订购关系