IPTV业务管理平台2.0订购接口.docVIP

订购及计费接口 业务订购/退订购流程 图4-5-1-1：即时业务订购流程图 链接：64:7001/iptv3a/user/subscribe/subscribe.do 接口协议内容 承载协议：1. HTTP GET 增值业务使用 2. SOAP EPG使用 接口方向：EPG服务系统重定向 – 业务管理平台 接口功能: 用户订购业务。 请求消息包含以下关键参数 业务订购请求参数 名称 说明 数据类型 长度（字节） SPID SP的唯一标识 string 8 M UserID IPTV用户业务编号 string 36 O ContentID 内容ID string 32 O ServiceID IPTV服务编号 string 20 M ProductID IPTV产品编号 string 16 O UserToken 业务管理平台为该用户分配的临时身份证明，可采用Cookie的方式传递 string 32 M ReturnURL 返回EPG服务页面的URL string 256 M Action 订购动作 1：订购；2：退订 Sting 1 M 返回参数 名称 说明 数据类型 长度（字节） Result 业务订购结果 0：成功 其他：失败 String 4 M Description 结果描述 String 256 O UserID IPTV用户业务编号 string 36 O UserToken 业务管理平台为该用户分配的临时身份证明，可采用Cookie的方式传递 string 32 O ServiceID IPTV服务编号 string 20 M ProductID IPTV产品编号 string 16 M ProductName IPTV产品名称 string 100 O PurchaseType 0：免费 1：按次支付 5：包月 int 4 M Fee 支付金额(以分为单位) int 4 O SPID SP的唯一标识 string 8 O TransactionID 订购的事务编号 string 40 O ExpiredTime 订购关系的失效时间， 格 式 为YYYYMMDDhhmmss。缺少该参数表示永久有效。 String 14 O 订购参数校验要求 UserToken必须有效，从UserToken可以找到UserID； Serviceid和Contentid必须两者存在其一； 通过UserID，可以从User表得到用户数据，用户状态正常； 通过ProductID，可以从Product表获得产品数据； 产品状态为发布状态（status=3）； 产品应该没有过期，过期时间小于当前时间； 如果是包月产品，应该至少还有一个月的使用时间，到期时间至少在一个月以后； 非CRM产品，其授权应该不存在； CRM产品在存在有效授权的情况下（ProductAuth表status=1），订购会先作废原有授权，然后继续进行，生成新的授权； 产品应该存在计费策略； 产品应该有服务对应关系。 退订购参数校验要求 UserToken必须有效，从UserToken可以找到UserID； Serviceid和Contentid必须两者存在其一； 通过UserID，可以从User表得到用户数据，用户状态正常； 通过ProductID，可以从Product表获得产品数据； 产品状态为发布状态（status=3）； 产品必须是包月产品，按次和免费产品均不可以退订购； 必须是有效授权，授权状态不能为过期（ProductAuth表status!=9）； 如果产品的授权还在免费期内，不可以退订购； 产品应该存在计费策略； 产品应该有服务对应关系； 如果是CRM产品，必须30天以后才可以退订购。 订购/退订购接口SOAP方式和HTTP方式异同 由于EPG订购采用SOAP方式，而增值业务订购采用HTTP方式，所以处理有所不同。 EPG处理请求与确认页面，具体说为：EPG订购由EPG负责订购请求页面，该页面直接通过服务鉴权接口，获得可以订购的产品列表，列表中已经包含产品价格及优惠内容等信息；IPTV3A平台判定是否可以订购/退订购，然后执行订购/退订购动作。 增值业务管理平台处理请求页面，确认页面由IPTV3A平台提供。增值业务平台没有实现单个增值业务业务鉴权接口，所以不会获得产品价格和优惠信息；订购的时候，由增值业务平台发起请求，IPTV3A平台生成确认页面，给用户说明产品，并列出优惠信息。 错误代码表 分类 代码 描述 全部 0 成功 订购关系 1001 该产品已经存在有效授权 　 1002 生成产品授权错 　 1003 产品授权无法插入数据库 　 1005 无有效产品授权 　 1004