互联星空技术规范--sp系统接口分册v1.2

'中国电信集团互联星空技术规范SP系统接口分册V1.2中国电信集团公司2004年1月80 目录1编制说明51.1目的51.2解释权51.3参考标准和文献52名词术语63CHINAVNET互联星空计划介绍73.1互联星空计划的内涵73.2互联星空计划的市场定位83.3互联星空计划服务的功能83.4SP的分类84接入功能及流程94.1网络结构94.2认证处理94.2.1一点认证的介绍94.2.2流程描述114.3计费及支付处理124.3.1概述124.3.2计费及支付流程144.4客户端软件的接入204.5对帐214.6结算214.7时钟同步215接口215.1SP系统提供的接口225.1.1退出接口225.1.2总帐对帐结果通知接口2480 5.1.3明细帐对帐结果通知接口275.1.4用户状态变更接口305.2互联星空系统提供的接口325.2.1认证接口325.2.2计次支付接口345.2.3包时段订购支付接口365.2.4包次订购支付接口395.2.5包次使用记录通知接口415.2.6锁定接口435.2.7续锁定接口465.2.8计流量支付接口485.2.9计时长支付接口515.2.10包时段服务使用记录通知接口535.2.11支付确认接口555.2.12总帐对帐接口575.2.13明细帐对帐接口595.2.14取消包时段订购接口615.2.15服务项目信息批量上传接口645.2.16离线支付接口686附录716.1附录1－省份标识表716.2附录2－编码规则716.2.1UserID716.2.2NickName726.2.3SPID726.2.4SPSecret726.2.5ServiceID726.2.6ServiceItemID726.2.7TransactionID7280 6.3附录3－UserProfile格式736.4附录4 －服务类型的schema定义736.4.1影视736.4.2音乐7680 编制说明1.1目的为了指导服务提供商（SP）开发与中国电信互联星空系统对接的应用，特制定本规范。本规范为中国电信集团公司企业规范，规定了SP系统与中国电信互联星空系统之间的应用层接口协议。1.2解释权本规范由中国电信集团广州研发中心起草。本规范的解释权属于中国电信集团公司。1.3参考标准和文献下列标准所包含的条文，通过本标准的引用而构成本标准的条文。在标准出版时，所示版本均为有效。所有标准都会被修改，使用本标准的各方应探讨使用下列标准最新版本的可能性。lRFC1738统一资源定位器（URL）lRFC2068超文本传输协议HTTP/1.1lRFC2109HTTP状态管理机制lRFC2145HTTP版本号的使用和解释lRFC1521BASE64算法lRFC18513DES算法lRFC1852SHA算法lIETFSSLV1.1(1996.1)安全套接层SecureSocketLayerl《ChinaVnet互联星空业务规范书（试行）》200280 1名词术语SP（ServiceProvider）加入到互联星空计划，提供收费服务的服务提供商。互联星空用户在互联星空系统中注册，使用互联星空服务的互联网用户，简称为用户。互联星空系统用于支撑中国电信互联星空业务的业务支撑系统，该系统是一套分布式的系统，分布在多个省份。一点认证SP系统建立对互联星空系统的信任联系。用户只要通过互联星空系统的认证，即可自由地访问SP提供的收费服务，而不需要再次输入SP系统的认证信息；通过与互联星空系统之间的通讯，SP系统也可以确保该用户是合法用户，从而为之提供服务。绑定用户指定其拥有的电信帐号作为其互联星空帐号付费手段的过程。接入SP与中国电信签约后，需要对其原有系统进行改造，与互联星空系统实现互通，为用户提供一点认证等服务、实现与中国电信对帐结算等功能。这个过程称为SP接入互联星空系统（包括省级中心和全国中心。全国中心可看作为一个特殊的省级中心，本文统一称为省级中心）。80 支付帐号用户拥有的中国电信帐号（如窄带帐号、宽带帐号、固话号码及小灵通号码等）。用户将该帐号与其互联星空帐号绑定后，中国电信可以代SP收费，并对收益分成。支付将用户使用收费服务所产生的费用扣除或累计的过程。SSL（SecuritySocketLayer）安全套接层，是面向连接的一种互联网应用层协议，用于通讯过程中保证客户端和服务端的数据完整性和保密性。SOAP(SimpleObjectAccessProtocol)简单对象访问协议，是Web服务技术的核心技术之一，用于Web服务调用的XML消息表示。NTP（NetWorkTimeProtocol）网络时钟协议。1ChinaVnet互联星空计划介绍以下从互联星空计划的内涵、市场定位及其服务的功能等方面进行简单介绍。有关互联星空计划业务方面的介绍，详见《ChinaVnet互联星空业务规范书（试行）》。1.1互联星空计划的内涵80 充分利用中国电信的用户资源、网络资源、应用支撑平台资源、营销网络、客户服务和宣传渠道等资源，营造互联网产业良性发展的生态环境，积极推动互联网产业链的可持续发展，创造互联网服务新的商业模式，通过聚合SP的内容和应用，为中国电信互联网用户提供丰富多彩的信息应用服务，实现用户、ISP和SP的多方共赢。1.1互联星空计划的市场定位ChinaVnet互联星空业务是中国电信在互联网应用层面的业务，中国电信将通过自营和聚合SP的内容和应用向用户提供统一的基于中国宽带互联网的多样化、个性化的互联网内容和应用服务。1.2互联星空计划服务的功能ChinaVnet互联星空计划将实现“一点接入，全网服务”、“一点认证，全网通行”和“一点结算，全网收益”。1)一点接入，全网服务各SP可以通过接入中国电信集团公司或各省、直辖市公司的互联星空系统，实现向ChinaNet全网范围内的用户提供收费的内容和应用服务。2)一点认证，全网通行China互联星空用户只需要进行一次应用层认证，就可享受互联星空系统所有SP提供的内容和应用服务。3)一点结算，全网收益为使各SP方便地获取其全网性业务的收益，中国电信向SP提供单点结算服务。1.3SP的分类按SP的服务范围，可以将SP划分为以下两类：l地方性SP。与某个省签约的SP称为地方性SP。地方性SP提供的内容服务只能供该省的互联星空用户访问，其服务目录信息可以在该省级中心的门户上展现。80 l全国性SP。与集团公司或代表集团公司的省公司签约的SP称为全国性SP。全国性SP提供的内容服务可以供全国范围的互联星空用户访问，其服务目录信息可以在全国中心的门户上展现。如果SP是与代表集团公司的省公司签约，则其服务目录信息也可以在该省的省级中心门户上展现。按SP是否使用互联星空提供的计费功能，可以将SP划分为以下两类：l自计费SP。自计费SP由互联星空系统提供认证和代收费服务，SP负责提供应用服务内容并计费。l代计费SP。代计费SP由中国电信互联星空系统提供认证、计费和代收费服务，SP负责提供应用服务内容。1接入功能及流程1.1网络结构SP通过ChinaNet连接到互联星空系统，网络结构示意图如下：图4-1网络结构示意图1.2认证处理1.2.1一点认证的介绍一点认证的定义详见第2章。80 1.1.1.1登录方式用户可以通过以下方式登录到互联星空：1)用户在互联星空网站上点击“登录互联星空”的LOGO；2)用户尚未登录，直接访问互联星空网站上的互联星空服务；3)用户在SP网站上点击“登录互联星空”的LOGO；4)用户尚未登录，直接访问SP网站上的互联星空服务。5)用户通过中国电信的拨号客户端直接自动登录互联星空。1.1.1.2认证令牌互联星空系统通过使用UserToken和SPToken实现一点认证的功能。UserToken和SPToken均为临时的身份凭证。其中，UserToken由互联星空系统生成并颁发给用户，作为中国电信赋予用户的临时身份凭证，其中包含了用户的详细登录信息；SPToken由SP系统根据互联星空系统提供的信息生成并颁发给用户，作为SP赋予用户的临时身份凭证，其中包含了用户的登录信息和在该SP上的授权信息。当用户登录到互联星空后，互联星空平台根据用户信息生成并颁发UserToken。当用户访问某个SP时，该SP系统如果不能辨别用户的身份，则通过重定向技术向互联星空平台提交身份验证请求，互联星空平台判断用户拥有合法的UserToken，则将相关信息返回给SP系统，SP系统生成并向用户颁发SPToken，并为之提供服务。当用户再次访问该SP时，SP系统通过判断用户是否拥有SPToken，即可自行决定用户是否有权限使用收费服务。1.1.1.3令牌的有效期SPToken是一个临时的身份凭证，具有有效期属性，超过指定的时间后，SPToken不再有效。此时SP系统需要在用户下一次访问其系统时再次向互联星空系统发出认证请求并根据认证结果生成新的SPToken。80 同样，UserToken也是一个临时的身份凭证，具有有效期属性，当超过指定的时间后，UserToken不再有效。互联星空系统需要再次验证用户的身份，以生成并颁发新的UserToken。为使用户获得较好的使用体验，互联星空系统生成一个新的SPToken时，可以同时延长UserToken的有效期。1.1.1流程描述如果用户拥有有效的SPToken，当用户访问、消费服务时，SP系统可辨认用户的身份，直接进入支付流程。以下讨论用户尚未拥有有效的SPToken，SP系统需要向互联星空系统提出认证请求的情况。1.1.1.1首次登录本流程适用于以下场景：用户尚未获得有效的UserToken，此时访问SP网站。图4－2首次登录流程示意图1)用户请求使用互联星空服务；2)SP通过重定向技术向省级中心提交认证请求（接口参见5.2.1）；3)省级中心显示登录页面；4)用户提交身份验证信息；5)省级中心将认证结果返回给SP系统；6)SP系统向用户返回相应页面。80 1.1.1.1后续登录本流程适用于以下场景：用户已经获得有效的UserToken，此时访问SP网站。图4-3后续登录流程示意图1)用户请求使用互联星空服务；2)SP通过重定向技术向省级中心提交认证请求（接口参见5.2.1）3)省级中心确认用户已经登录互联星空，直接将认证结果返回给SP系统；4)SP系统向用户返回相应页面。1.1.1.2用户退出用户请求退出互联星空后，其本次登录所获得的临时身份凭证将全部失效，同时系统也将回收为用户提供服务的系统资源。互联星空系统将通知用户登录后访问过的所有SP系统。接收到用户的退出通知后，SP系统可以做相应的处理工作。相关接口参见5.1.1。1.2计费及支付处理1.2.1概述1.2.1.1服务模型定义 服务类型是指对不同收费内容的分类，如电影、音乐、游戏等。80 服务项目是指某SP提供的收费内容，是面向用户并供用户定购和使用的实体，例如一首歌、一部电影。服务项目属于某个服务类型，相同服务类型的服务项目使用相同的属性字段进行描述。例如，不同的歌曲都具有主唱、作词、作曲、语言等属性。服务项目可以是多个其它服务项目的集合，例如“2002年十大金曲”代表十首歌的集合，“70年代的歌”代表属于七十年代的所有歌的集合，它们都是一个服务项目。服务是由某SP提供的一个或多个服务项目的集合，集合中的服务项目具有相同的资费定义。例如：“2002年十大金曲”和“70年代的歌”都在“2元包月歌集”服务中，包月定购其中任意一个服务项目都需要支付2元。1.1.1.1计费/支付方式互联星空业务需要支持以下计费/支付方式：l包时段支付。包时段收费是指用户支付一定金额，在指定的时间范围内可以任意使用指定的SP服务。SP可以在此基础上将服务包装成包月或包季度等服务提供给用户。用户可以指定该时段结束后，是否自动继续包等长的时段。用户也可以取消继续包等长时段的设置。l包次支付。包次支付是指用户可以一次性购买某个互联星空服务的多次使用权。用户每使用一次该互联星空服务，则其余下可使用次数减一。当其可使用次数为零时，用户需要再次购买方可使用该服务。l按次支付。按次支付是指用户每使用一次服务，需要为之支付一次费用的支付方式。l按时长计费/支付。按时长计费/支付是指按照用户使用服务的时间长短进行计费/支付。l按流量计费/支付。按流量计费/支付是指按照用户使用服务所产生的流量大小进行计费/支付。l离线支付。离线支付是指由SP发起的扣除用户费用的过程。此过程无需用户的直接确认。80 1.1.1计费及支付流程本节中提及的用户，如无特殊说明，均指已经通过身份认证的合法用户。1.1.1.1按次收费方式图4-4按次收费流程示意图1)用户点击SP提供的互联星空服务；2)SP系统通过重定向技术向其接入的省级中心发送按次购买请求（接口参见5.2.2）；3)SP接入的省级中心显示购买的详细信息（购买金额等），要求用户确认；4)用户确认；5)SP接入的省级中心向SP系统返回购买结果信息；6)SP系统收到购买结果信息后向用户提供服务或显示错误页面；7)SP向省级中心发送确认信息。省级中心收到该信息后方可以正式扣费（接口参见5.2.11）。80 1.1.1.1包时段收费方式1.1.1.1.1包时段订购图4-5包时段订购流程示意图1)用户请求订购SP的包时段服务；2)SP系统向其接入的省级中心发送包时段订购请求（接口参见5.2.3）；3)省级中心向用户显示详细的支付信息（支付金额等），要求用户确认；4)用户确认；5)省级中心向SP返回订购结果信息；6)SP系统收到购买结果信息后向用户提供服务或显示错误页面；7)SP系统向省级中心发送确认信息。省级中心收到该信息后方可以正式扣费（接口参见5.2.11）。1.1.1.1.2使用包时段服务用户申请使用包时段服务时，SP根据SPToken的信息自行决定向用户提供服务，不需要与互联星空平台交互。服务使用完毕后，SP向其接入的省级中心发送使用服务记录，发送接口和具体字段的取值请参见5.2.10。80 1.1.1.1.1包时段服务订购的取消包时段服务可以在使用过程中取消，相关费用根据协议规定的方法进行计算。图4-6取消包时段订购服务流程示意图1)用户在SP网站上选择取消包时段订购；2)SP系统内部进行服务订购取消操作；3)SP调用省中心提供的服务订购取消接口向接入省中心发送取消订购的通知（接口参见5.2.14）；4)接入省中心进行服务订购取消的内部处理；5)接入省中心通知SP处理结果；6)SP通知用户操作结果。1.1.1.2包次收费方式包次订购是指用户可以一次性购买某个互联星空服务的多次使用权。用户每使用一次该互联星空服务，则其可使用次数减一。当其可使用次数为零时，用户需要再次购买方可使用该服务。80 1.1.1.1.1包次订购流程同4.3.2.2.1。1.1.1.1.2使用包次服务图4-7使用包次服务流程示意图1)用户在SP系统上提出使用包次服务申请；2)SP系统向省中心发送包次服务支付请求（接口参见5.2.5）；3)SP接入的省级中心显示包次支付信息，要求用户确认；4)用户确认；5)SP接入的省级中心向SP系统返回购买结果信息；6)SP系统收到购买结果信息后为用户提供相应的互联星空服务；7)SP系统向省级中心发送确认信息。省级中心收到该信息后处理包次支付，更新用户剩余的可用次数（接口参见5.2.11）。1.1.1.2按时长收费方式80 为了支持预付费卡类支付手段以及用户的信用度控制，特设置锁定（续锁定）方式实现按时长计费服务。其中，自计费型SP请求锁定金额；代计费型SP请求锁定时长，计费由互联星空系统实现。图4-8按时长收费流程示意图1)用户请求使用SP的按时长计费服务；2)SP通过重定向技术发送锁定请求（接口参见5.2.6）；3)SP接入的省级中心显示该服务的费率信息，提示用户确认；4)用户确认；5)省级中心返回锁定结果；6)在用户的使用过程中，如果锁定额度已经用尽，SP系统发送续锁定请求，该请求同时表示对上一个锁定的确认，即省级中心可以扣除上一个锁定请求锁定的费用（接口参见5.2.7）；7)省级中心返回续锁定结果（第6和第7步可以多次出现）；8)当用户使用完毕后，SP系统发送按时长计费/支付请求，将最后一次锁定后发生的使用时长（或金额）通知省级中心（接口参见5.2.9）；9)SP接入的省级中心向SP系统返回请求处理结果。1.1.1.1按流量收费方式80 为了支持预付费卡类支付手段以及用户的信用度控制，特设置锁定（续锁定）方式实现按流量计费服务。其中，自计费型SP请求锁定金额；代计费型SP请求锁定流量，计费由互联星空系统实现。图4-9按流量收费流程示意图1)用户请求使用SP的按流量计费服务；2)SP通过重定向技术发送锁定请求（接口参见5.2.6）；3)SP接入的省级中心显示该服务的费率信息，提示用户确认；4)用户确认；5)省级中心返回锁定结果；6)在用户的使用过程中，如果锁定额度已经用尽，SP系统发送续锁定请求，该请求同时表示对上一个锁定的确认，即省级中心可以扣除上一个锁定请求锁定的费用（接口参见5.2.7）；7)省级中心返回续锁定结果（第6和第7步可以多次出现）；8)当用户使用完毕后，SP系统发送按流量计费/支付请求，将最后一次锁定后发生的使用流量（或金额）通知省级中心（接口参见5.2.8）；9)SP接入的省级中心向SP系统返回请求处理结果。80 1.1.1.1离线收费方式离线支付适用于以下的应用场景：l包时段订购服务的续订购；l先体验、后支付类服务的支付。离线支付的应用条件：l经互联星空中心许可的离线支付资质；l提供离线支付方式的服务的首个定购过程须采用在线支付方式，需要用户确认此项服务可以采用离线支付方式对续定购扣费；l用户在SP发起首个离线支付前可以取消续定购；l对于提供离线支付方式的包时段服务，在包时段结束后提供服务免费使用延长期，延长期内若用户未取消定购则仍允许用户享受服务，延长期过后才允许SP未续定购发送离线支付请求。1.2客户端软件的接入如果SP提供的服务是基于特定客户端软件的，且该客户端软件不适合做相应的修改（例如国外游戏软件），则使用该类型客户端软件的用户不能享受一点认证的服务。否则，通过修改客户端软件，使其支持浏览器功能，并遵循相关规范，则可使用户享受到一点认证的服务。使用客户端软件的服务可以通过网站购买的方式实现代收费。以基于客户端软件的游戏为例，用户访问SP网站，选择网站上提供的购买游戏点数的按次收费服务，互联星空系统为其收取该服务的费用，SP系统负责将该点数转入到对应游戏帐号中。例如，用户登录互联星空后，点击服务名为“购买游戏点数100点，资费：每次2元”的服务，则互联星空系统将该费用累计到其支付帐号中，实现代收费。SP系统需要自行将100点存入用户指定的游戏帐号中。在整个过程中互联星空系统不与客户端软件发生交互。80 1.1对帐在帐期内第N天时的规定时间，SP系统与其接入的互联星空系统核对第（N－2）天的帐。对中国电信所有互联星空用户使用该SP提供的服务所产生的费用记录进行核对。具体方式为：SP上传总帐，如果误差在规定的比例内，则以中国电信的数据为准；否则SP上传明细帐，互联星空系统下发明细帐差异结果，进行人工处理。1.2结算每个结算周期结束后，SP与其接入的省级中心进行“一点结算”。具体结算办法请参看《ChinaVnet互联星空业务规范书（试行）》。1.3时钟同步SP系统的服务器需要按照中国电信的要求，与指定的国际标准NTP服务器每日同步。2接口互联星空平台根据其预先保存的SP系统IP地址以及颁发给SP的密钥来辨认SP系统的身份。以下定义的接口需要遵循如下规定：1)本规范接口的所有数据类型定义均遵循XML语言定义规范（W3C2001版规范，详见http://www.w3.org/2001/XMLSchema）；2)对于重定向接口中的字符串参数，必须进行控制码的转义。方法为UrlEncoding（Str），其具体实现参见RFC1738。3)对于重定向接口，定义#为返回参数与ReturnUrl之间的连接符变量，如果ReturnUrl中包含查询参数，#取值为“&”，否则取值为“?”。4)对于非重定向接口，通过WebService实现。对Web80 Service的调用采用SOAP调用方法。SOAP接口若无特殊说明，均承载在HTTP协议上。承载SOAP调用的HTTP请求头中使用POST命令。本规范不对其目的地址的URL作具体规定。1)两个实体间通过统一的WebService完成各SOAP方法的调用。例如：互联星空系统向SP系统提供的接口方法都封装在一个WebService中。2)对于SOAP调用接口，服务提供方必须首先检查服务请求方的IP地址的合法性方可提供服务。3)所有SOAP调用的XML编码均采用UTF-8方式；4)所有SOAP调用方法的URL均作为SOAPAction的取值。5)为了保证接口未来的平滑升级，所有接口方法的URL均需要包含版本信息，且URL的大小写不敏感。6)3DES算法中，InitialVector取值为零。7)接口描述中的斜体部分表示变量在系统运行中的实际取值。8)本规范中的接口若无特殊说明，均为同步调用接口。9)ChinaVnetCenter是指相关互联星空系统的名字空间，组成形式是service.xx.chinavnet.com。其中，xx是省份标识，例如广东省为gd。其他省份标识详见附录1。10)SPCenter是指接入互联星空系统的SP系统的域名，该域名由SP指定。11)本规范定义的使用重定向的接口中，不特别指定对应的处理页面的类型，只定义对应处理页面的名称，如登录页面，只定义为login；对于jsp页面，应补全为login.jsp，对于asp页面，应补全为login.asp，以此类推。12)对于采用HTTPS的接口，只要求检查服务器端的证书，不要求检查客户端的证书。1.1SP系统提供的接口1.1.1退出接口接口采用SOAP协议和HTTPS协议。接口方法为：80 http://SPCenter/Logout接口请求消息LogoutRequest包含如下信息名称说明数据类型长度（字节）SenderID互联星空系统的省份码String2SPIDSP的唯一标志Sring8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标志String11NickName用户昵称String40定义LogoutRequest的schema格式如下：接口应答消息LogoutResponse包含如下信息名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标志String1180 Result0：成功-1001：失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义LogoutResponse的schema格式如下：1.1.1总帐对帐结果通知接口接口采用SOAP协议和HTTPS协议。接口方法为：http://SPCenter/GeneralLedgerFeedback接口请求消息GeneralLedgerFeedbackRequest包含如下信息：名称说明数据类型长度（字节）SenderID互联星空系统的省份码String280 Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp与对帐请求消息中的时间戳一致String≤18SPIDSP的唯一标识String8LedgerType对帐类型，00：日对帐01：月对帐String2StartDate时间戳，从1970年1月1日0时开始的毫秒数String<=18EndDate时间戳，从1970年1月1日0时开始的毫秒数String<=18Result对帐结果信息。1：对帐成功，误差在定义的范围内0：对帐成功，金额相同-1001：对帐不平-1002：还不能进行该日期的对帐-1003：对帐期已过，不能进行该日期对帐Int4TotalCount总笔数，表示对帐请求应答方的实际发生费用的帐单总比数Long8TotalFee总金额（以分为单位），表示对帐请求应答方的帐单总金额Long8定义GeneralLedgerFeedbackRequest的Schema的格式如下：80 接口应答消息GeneralLedgerFeedbackResponse包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Result0：接收成功-1001：接收失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义GeneralLedgerFeedbackResponse的Schema格式如下：80 1.1.1明细帐对帐结果通知接口接口采用SOAP协议，接口采用HTTPS协议。接口方法为：http://SPCenter/DetailLedgerFeedback接口请求消息DetailLedgerFeedbackRequest包含如下信息：名称说明数据类型长度（字节）SenderID互联星空系统的省份码String2Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp与对帐请求消息中的时间戳一致String18SPIDSP编码String8LedgerType对帐类型，00：日对帐01：月对帐String2StartDate时间戳，从1970年1月1日0时开始的毫秒数String<=18EndDate时间戳，从1970年1月1日0时开始的毫秒数String<=18Result1：误差在定义的范围内，有以下的不平详单0：表示总金额和总笔数都吻合，对帐成功；-1001误差在定义的范围外，有以下的不平详单Int4SucessCount成功对帐的总比数Long8SucessFee成功对帐的总金额Long8FailedCount不平帐目的总比数Long8FailedFee不平帐目的总金额Long880 FailedRecords不平帐目集合FailedRecords其中，FailedRecords包含如下信息：名称说明数据类型长度（字节）FailedRecord不平帐目记录，可出现多次Element其中，FailedRecord包含如下信息：名称说明数据类型长度（字节）TransactionID不平帐单的交易号String36FailCode不平原因：-1：SP中存在，互联星空系统中缺失-2：互联星空系统中存在，SP中缺失-3：金额不对应Int4定义DetailLedgerFeedbackRequest消息的Schema格式如下：80 接口应答消息DetailLedgerFeedbackResponse包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Result结果0：接收成功-1001：接收失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义DetailLedgerFeedbackResponse的Schema的格式如下：80 1.1.1用户状态变更接口当互联星空用户状态发生变化的时候，需要告知相关的SP系统。接口采用SOAP协议，接口采用HTTPS协议。接口方法为：http://SPCenter/UserStatusChange接口请求消息UserStatusChangeRequest包含如下信息：名称说明数据类型长度（字节）SenderID互联星空系统的省份码String2Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18StatusRecords帐号状态变更记录集合StatusRecords其中，StatusRecord包含如下信息：名称说明数据类型长度（字节）StatusRecord帐号状态变更记录，可出现多次Element其中，StatusRecord包含如下信息：名称说明数据类型长度（字节）UserID用户的唯一标志String11Status用户帐号的状态：01：正常态；02：正常暂停态；03：欠费暂停态；04：黑户暂停态；05：注销态；String2定义UserStatusChangeRequest消息的Schema格式如下：80 应答消息UserStatusChangeResponse包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Result处理结果：0：成功-1001：失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义UserStatusChangeResponse的Schema格式如下：80 1.1互联星空系统提供的接口1.1.1认证接口1）请求认证接口采用重定向方式。接口方法为：http://ChinaVnetCenter/v1.2/Login？SPTokenRequest＝SPTokenRequestValueSPTokenRequestValue为接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18ReturnURL互联星空系统返回认证结果时需要调用的URLString100SPTokenRequestValue的生成算法如下：Digest=Base64(Hash(ReturnURL+“$”+TimeStamp))80 其中，Hash算法采用SHA-1。SPTokenRequestValue=URLEncoding(SPID+“$”+Base64(Encrypt(ReturnURL+“$”+TimeStamp+“$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。2）返回认证结果接口采用重定向方式。接口方法为：http://ReturnURL#Source＝chinavnet&SPTokenResponse=SPTokenResponseValue其中，ReturnURL从SPTokenRequest中获得。SPTokenResponseValue为接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标识String11NickName昵称String40ExpireTime失效时间，从1970年1月1日0时开始的毫秒数String≤18UserProfile用户在该SP的授权信息String≤3000Result认证结果：0：用户认证通过-1：用户不存在-2：用户状态不正常-1001：用户/密码错误-1002：用户取消认证-10001：包数据格式不正确Int480 -10002：数据校验不正确SPTokenResponseValue的生成算法如下：Digest=Base64(Hash(Result+“$”+UserID+“$”+NickName＋“$”＋TimeStamp+“$”＋ExpireTime+“$”+UserProfile))其中，Hash算法采用SHA-1。SPTokenResponseValue=URLEncoding(SPID+“$”+Base64(Encrypt(Result+“$”+UserID+“$”+NickName＋“$”＋TimeStamp+“$”＋ExpireTime+“$”+UserProfile+“$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。1.1.1计次支付接口1）请求计次支付接口采用重定向方式。接口方法为：http://ChinaVnetCenter/v1.2/PayByItem?SPItemRequest=SPItemRequestValueSPItemRequestValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18ReturnURL互联星空系统返回计次支付结果时需要调用的URLString100UserIDString1180 用户的唯一标识，该字段只用于审核SP操作。互联星空系统从UserToken中取得实际用于扣费的用户的唯一标识，并核对该字段是否与UserToken中的用户唯一标识相同，如果相同，提示用户扣费，否则，根据情况为用户显示不同的错误提示。TransactionID交易号，由SP产生，顺序累加，步长为1（一对请求和应答的交易号必须相同）String36ServiceID用户消费的服务IDString16ServiceItemID服务项目IDString36ItemName服务项目名称String100Fee支付金额（以分为单位）Int4SPItemRequestValue的生成算法如下：Digest=Base64(Hash(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+Fee))其中，Hash算法采用SHA-1。SPItemRequestValue=URLEncoding(SPID+“$”+Base64(Encrypt(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+Fee+“$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。2）返回计次支付结果接口采用重定向方式。接口方法：http://ReturnURL#Source＝chinavnet&SPItemResponse=SPItemResponseValue其中，ReturnURL从SPItemRequest中获得。SPItemResponseValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）80 SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与计次支付请求相同String36Result0：成功-1001：用户余额（信用）不足-1002：用户取消支付-10001：包数据格式不正确-10002：数据校验不正确Int4SPItemResponseValue的生成算法如下：Digest=Base64(Hash(Result+“$”+TransactionID+“$”+TimeStamp))其中，Hash算法采用SHA-1。SPItemResponseValue=URLEncoding(SPID+“$”+Base64(Encrypt(Result+“$”+TransactionID+“$”+TimeStamp+”$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。1.1.1包时段订购支付接口1）请求计次支付接口采用重定向方式。接口方法为：http://ChinaVnetCenter/v1.2/PayByPeriod?SPPeriodRequest=SPPeriodRequestValueSPPeriodRequestValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤1880 ReturnURL互联星空系统返回计次支付结果时需要调用的URLString100UserID用户的唯一标识，该字段只用于审核SP操作。互联星空系统从UserToken中取得实际用于扣费的用户的唯一标识，并核对该字段是否与UserToken中的用户唯一标识相同，如果相同，提示用户扣费，否则，根据情况为用户显示不同的错误提示。String11TransactionID交易号，由SP产生，顺序累加，步长为1（一对请求和应答的交易号必须相同）String36ServiceID用户消费的服务IDString16ServiceItemID服务项目IDString36ItemName服务项目名称String100Fee支付金额（以分为单位）Int4StartTime包时段开始时间，从1970年1月1日0时开始的毫秒数。String≤18EndTime包时段结束时间，从1970年1月1日0时开始的毫秒数。String≤18IfExtend是否自动延续：0：是1：否String1SPPeriodRequestValue的生成算法如下：Digest=Base64(Hash(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+Fee+“$”+StartTime+“$”+EndTime+“$”+IfExtend))其中，Hash算法采用SHA-1。80 SPPeriodRequestValue=URLEncoding(SPID+“$”+Base64(Encrypt(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+Fee+“$”+StartTime+“$”+EndTime+“$”+IfExtend+“$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。2）返回支付结果接口采用重定向方式。接口方法：http://ReturnURL#Source＝chinavnet&SPPeriodResponse=SPPeriodResponseValue其中，ReturnURL从SPPeriodRequest中获得。SPPeriodResponseValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与计次支付请求相同String36Result0：成功-1001：用户余额（信用）不足-1002：用户取消支付-10001：包数据格式不正确-10002：数据校验不正确Int4SPPeriodResponseValue的生成算法如下：Digest=Base64(Hash(Result+“$”+TransactionID+“$”+TimeStamp))其中，Hash算法采用SHA-1。SPPeriodResponseValue=URLEncoding(SPID+“$”+Base64(Encrypt(Result+“$”+TransactionID+“$”+TimeStamp+”$”+Digest))80 其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。1.1.1包次订购支付接口1）请求包次支付接口采用重定向方式。接口方法为：http://ChinaVnetCenter/v1.2/PayByBatch?SPBatchRequest=SPBatchRequestValueSPBatchRequestValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18ReturnURL互联星空系统返回计次支付结果时需要调用的URLString100UserID用户的唯一标识，该字段只用于审核SP操作。互联星空系统从UserToken中取得实际用于扣费的用户的唯一标识，并核对该字段是否与UserToken中的用户唯一标识相同，如果相同，提示用户扣费，否则，根据情况为用户显示不同的错误提示。String11TransactionID交易号，由SP产生，顺序累加，步长为1（一对请求和应答的交易号必须相同）String36ServiceID用户消费的服务IDString16ServiceItemID服务项目IDString36ItemName服务项目名称String10080 Fee支付金额（以分为单位）Int4Count包次订购的次数。Int4SPBatchRequestValue的生成算法如下：Digest=Base64(Hash(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+Fee+“$”+Count))其中，Hash算法采用SHA-1。SPBatchRequestValue=URLEncoding(SPID+“$”+Base64(Encrypt(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+Fee+“$”+Count+“$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。2）返回支付结果接口采用重定向方式。接口方法：http://ReturnURL#Source＝chinavnet&SPBatchResponse=SPBatchResponseValue其中，ReturnURL从SPBatchRequest中获得。SPBatchResponseValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与计次支付请求相同String36Result0：成功-1001：用户余额（信用）不足-1002：用户取消支付Int480 -10001：包数据格式不正确-10002：数据校验不正确SPBatchResponseValue的生成算法如下：Digest=Base64(Hash(Result+“$”+TransactionID+“$”+TimeStamp))其中，Hash算法采用SHA-1。SPBatchResponseValue=URLEncoding(SPID+“$”+Base64(Encrypt(Result+“$”+TransactionID+“$”+TimeStamp+“$”＋Digest))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。1.1.1包次使用记录通知接口1）请求接口采用重定向方式。接口方法为：http://ChinaVnetCenter/v1.2/BatchUsageRecord?SPBatchUsageRequest=SPBatchUsageRequestValueSPBatchUsageRequestValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18ReturnURL互联星空系统返回结果时需要调用的URLString100UserID用户的唯一标识。String11OriginalTransactionID该包次服务的订购交易号String36CurrentTransactionID包次服务的该次使用交易号String36ServiceID用户消费的服务IDString1680 ServiceItemID服务项目IDString36ItemName服务项目名称String100SPBatchRequestValue的生成算法如下：Digest=Base64(Hash(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+OriginalTransactionID+“$”+CurrentTransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName))其中，Hash算法采用SHA-1。SPBatchRequestValue=URLEncoding((SPID+“$”+Base64(Encrypt(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+OriginalTransactionID+“$”+CurrentTransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。2）返回结果接口采用重定向方式。接口方法：http://ReturnURL#Source＝chinavnet&SPBatchUsageResponse=SPBatchUsageResponseValue其中，ReturnURL从SPBatchRequest中获得。SPBatchUsageResponseValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18CurrentTransactionID交易号，与请求的相同String36Result0：成功-1001：失败Int480 -10001：包数据格式不正确-10002：数据校验不正确SPBatchUsageResponseValue的生成算法如下：Digest=Base64(Hash(Result+“$”+CurrentTransactionID+“$”+TimeStamp))其中，Hash算法采用SHA-1。SPBatchUsageResponseValue=URLEncoding(SPID+“$”+Base64(Encrypt(Result+“$”+CurrentTransactionID+“$”+TimeStamp+“$”＋Digest))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。1.1.1锁定接口1）请求锁定接口采用重定向方式。接口方法为：http://ChinaVnetCenter/v1.2/Lock?SPLockRequest＝SPLockRequestValueSPLockRequestValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18ReturnURL互联星空系统返回锁定结果时需要调用的URLString100UserID用户的唯一标识String11TransactionID交易号，由SP产生，顺序累加，步长为1（一对请求和应答的交易号必须相同）String36ServiceID用户消费的服务IDString1680 ServiceItemID服务项目IDString36ItemName服务项目名称String100LockType锁定类别01：金额02：时长03：流量String2LockAmount锁定的金额（以分为单位）、或/时长（以秒为单位）、或流量（以字节为单位）Long8ExpireTime锁定的失效时间。当到达失效时间时尚未提交对该锁定的确认请求时，互联星空系统自动将取消该锁定请求。取值为：从1970年1月1日0时开始的毫秒数String≤18SPLockRequestValue的生成算法如下：Digest=Base64(Hash(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+LockAmount+“$”＋ExpireTime))其中，Hash算法采用SHA-1。SPLockRequestValue=URLEncoding(SPID+“$”+Base64(Encrypt(ReturnURL+“$”+TimeStamp+“$”+UserID+“$”+TransactionID+“$”+ServiceID+“$”+ServiceItemID+“$”+ItemName+“$”+LockType+“$”+LockAmount+“$”＋ExpireTime+“$”+Digest)))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。2）返回锁定结果接口采用重定向方式。接口方法如下：http://ReturnURL#Source＝chinavnet&SPLockResponse=SPLockResponseValue80 其中，ReturnURL从SPLockRequest中获得。SPLockResponseValue是接口参数值，包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，由SP产生，顺序累加，步长为1（一对请求和应答的交易号必须相同）String36Result1：锁定的数额小于请求数（不能再发送续锁定请求）0：锁定请求的数额成功-1001：锁定失败（可锁定的数额为0）-10001：包数据格式不正确-10002：数据校验不正确Int4LockedAmount实际锁定的金额（以分为单位）、或/时长（以秒为单位）、或流量（以字节为单位），若锁定不成功，则取值为0Long8SPLockResponseValue的生成算法如下：Digest=Base64(Hash(Result+“$”+TimeStamp+“$”+TransactionID+“$”+LockedAmount))其中，Hash算法采用SHA-1SPLockResponseValue=URLEconding(SPID+“$”+Base64(Encrypt(Result+“$”+TimeStamp+“$”+TransactionID+“$”+LockedAmount+”$”+Digest))其中，加密算法采用3DES，Key=SPSecret，SPSecret是互联星空颁发给该SP的密钥。80 1.1.1续锁定接口接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/NextLock续锁定接口的请求消息NextLockResquest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标识String11TransactionID交易号，与同一次计量支付事务中的锁定请求相同String36SequenceID锁定序列号。每续锁定一次加一，第一次续锁定为2。本次续锁定请求同时表示对相同交易号，本锁定序列号减1的续锁定（即上一次续锁定）的确认。如果本次续锁定为第一次续锁定，则本次请求同时表示对同一次事务中的锁定请求的确认。互联星空系统应该对上一次（续）锁定的金额进行扣除或累加。Int4LockType锁定类别01：金额02：时长03：流量String2LockAmount锁定的金额（以分为单位）、或/时长（以秒为单位）、或流量（以字节为单位）Long880 定义NextLockResquest消息的Schema格式如下：续锁定接口的应答消息NextLockResponse包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与同一次续锁定请求的相同String36Result1：锁定的数额小于请求数（不能再发送续锁定请求）0：锁定请求的数额成功-1001：锁定失败（可锁定的数额为0）-1002：TransactionID不正确-1003：SequenceID不正确-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256Long880 LockedAmount实际锁定的金额（以分为单位）、或/时长（以秒为单位）、或流量（以字节为单位），若锁定不成功，则取值为0SenderID发送者的标识，取其省份码String2定义NextLockResponse消息的Schema格式如下：1.1.1计流量支付接口接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/PayByFlux请求消息PayByFluxRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64String80 (SHA1(SPSecret＋TimeStamp))TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标识String11TransactionID交易号，与同一次计量支付事务中的锁定请求相同String36FeeType01：代扣费，取此值时Fee字段的值是待扣的金额，可以不填Flux字段。02：代计费String2StartTime使用服务开始时间，从1970年1月1日0时开始的毫秒数。String≤18EndTime使用服务结束时间，从1970年1月1日0时开始的毫秒数。String≤18Flux流量（以字节为单位）。Long8Fee费用（以分为单位），自计费型SP通过该字段指定需要扣除的费用。Int4定义PayByFluxRequest消息的Schema格式如下：80 应答消息PayByFluxResponse包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与同一次计量支付请求的相同String36Result交易结果0：成功-1002：TransactionID不正确-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256SenderID发送者的标识，取其省份码String2定义PayByFluxResponse消息的Schema格式如下：80 1.1.1计时长支付接口接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/PayByDuration请求消息PayByDurationRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标识String11TransactionID交易号，与同一次计量支付事务中的锁定请求相同String36FeeType01：代扣费，取此值时Fee字段的值是待扣的金额，可以不填StartTime和EndTime。02：代计费String2StartTime使用服务开始时间，从1970年1月1日0时开始的毫秒数。String≤18EndTime使用服务结束时间，从1970年1月1日0时开始的毫秒数。String≤18Fee费用（以分为单位），自计费型SP通过该字段指定需要扣除的费用。Int4定义PayByDurationRequest消息的Schema格式如下：80 应答消息PayByDurationResponse包含如下信息：名称说明数据类型长度（字节）SPID互联星空系统颁发给SP的唯一标识String8TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与同一次计量支付请求的相同String36Result交易结果0：成功-1002：TransactionID不正确-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256SenderID发送者的标识，取其省份码String2定义PayByDurationResponse消息的Schema格式如下：80 1.1.1包时段服务使用记录通知接口本接口用于互联星空系统记录用户使用包时段服务的详细使用情况。该接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/DurationUsageRecord接口请求消息DurationUsageRecordRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标识String11TransactionID交易号String36ServiceID用户消费的服务IDString16ServiceItemID服务项目IDString36ItemName服务项目名称String100StartTime使用服务开始时间，从1970年1月1日0时开始的毫秒数。String≤1880 EndTime使用服务结束时间，从1970年1月1日0时开始的毫秒数。String≤18定义DurationUsageRecordRequest的Schema的格式如下：接口应答消息DurationUsageRecordResponse包含如下信息：名称说明数据类型长度（字节）SenderID应答方的省份码String2TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与相应请求中的交易号相同String36Result交易结果0：成功-1001：失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义DurationUsageRecordResponse的Schema的格式如下：80 1.1.1支付确认接口该接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/PaymentConfirm接口请求消息PaymentConfirmRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号，与SP在该次事务中产生的交易号相同String36UserID用户的唯一标识String11定义PaymentConfirmRequest的Schema的格式如下：80 接口应答消息PaymentConfirmResponse包含如下信息：名称说明数据类型长度（字节）SenderID互联星空系统的省份码String2TransactionID交易号，与相应请求的交易号相同String36Result交易结果0：成功-1001：失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义PaymentConfirmResponse的Schema的格式如下：80 1.1.1总帐对帐接口接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/GeneralLedgerAsync接口类型为异步，总帐对帐接口请求消息GeneralLedgerAsyncRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，即从1970年1月1日0时开始的毫秒数String≤18LedgerType对帐类型，00：日对帐01：月对帐String2StartDate时间戳，从1970年1月1日0时开始的毫秒数String<=8EndDate时间戳，从1970年1月1日0时开始的毫秒数String<=8TotalCount总笔数，表示对帐请求发起方的实际发生费用的帐单总笔数。Long8TotalFee总金额（以分为单位），表示详单总金额Long8定义GeneralLedgerAsyncRequest消息的Schema的格式如下：80 总帐对帐接口应答消息GeneralLedgerAsyncResponse包含如下信息：名称说明数据类型长度（字节）SenderID互联星空系统的省份码String2TimeStamp与对帐请求消息中的时间戳一致String≤18Result交易结果0：接收成功-1001：接收失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义GeneralLedgerAsyncResponse消息的Schema的格式如下：80 1.1.1明细帐对帐接口接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/DetailLedgerAsync接口采用异步方式，明细帐对帐接口请求消息DetailLedgerAsyncRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，即从1970年1月1日0时开始的毫秒数String≤18LedgerType对帐类型，00：日对帐01：月对帐String2StartDate时间戳，从1970年1月1日0时开始的毫秒数String<=18EndDate时间戳，从1970年1月1日0时开始的毫秒数String<=18TotalCount明细帐的总笔数，表示对帐请求发起方的实际发生费用的帐单总笔数。Long880 TotalFee明细帐的总金额（以分为单位）Long8DetailRecords详细交易记录DetailRecords其中，DetailRecords包含如下信息：名称说明数据类型长度（字节）DetailRecord交易记录，可出现多次Element其中，DetailRecord包含如下信息：名称说明数据类型长度（字节）TransactionID交易号String36FeeTransactionID对应的交易金额（以分为单位）Long8定义DetailLedgerAsyncRequest消息的Schema格式如下：80 接口应答消息DetailLedgerAsyncResponse包含如下信息：名称说明数据类型长度（字节）SenderID互联星空系统的省份码String2Result交易结果0：接收成功-1001：接收失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义DetailLedgerAsyncResponse的Schema的格式如下：1.1.1取消包时段订购接口80 当用户在SP的网站上取消包时段订购的时候，SP系统调用本接口告知互联星空系统不用再对用户进行包时段计费。接口采用SOAP协议和HTTPS协议。接口方法名为http://ChinaVnetCenter/v1.2/CancelSubscription。接口请求消息CancelSubscriptionRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8UserID用户的唯一标识String11Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18TransactionID交易号String36ServiceID用户消费的服务IDString16ServiceItemID服务项目IDString36ItemName服务项目名称String100定义CancelSubscriptionRequest的Schema格式如下：接口应答消息CancelSubscriptionResponse包含如下信息：名称说明数据类型长度（字节）80 SenderID互联星空系统的省份码String2TransactionID交易号，与SP在该次交易中调用计次支付接口时生成的交易号相同（一对请求和应答的交易号必须相同）String36TimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18Result交易结果0：成功-1001：失败-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义CancelSubscriptionResponse的Schema格式如下：80 1.1.1服务项目信息批量上传接口接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/ServiceItemUpload服务批量上传接口请求消息ServiceItemUploadRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp上传服务的时间戳，即从1970年1月1日0时开始的毫秒数String≤18ServiceItemRecords服务项目信息ServiceItemRecords其中，ServiceItemRecords包含如下信息：名称说明数据类型长度（字节）ServiceItemRecord服务项目信息记录，可出现多次Element其中，ServiceItemRecord包含如下信息：名称说明数据类型长度（字节）ServiceItemID服务项目IDString36OpeationType操作码：01：新增服务项目信息02：修改服务项目信息03：删除服务项目信息String2ItemName服务项目名称String60ItemDesc服务项目描述String300ItemURL服务项目URLString25680 ItemProperty服务项目的属性数据，该属性数据是一段描述服务项目属性的XML文档,该XML的文法必须符合相关服务类型定义的schema。String4000StartTime服务项目有效期的起始时间，即从1970年1月1日0时开始的毫秒数String≤18EndTime服务项目有效期的结束时间，即从1970年1月1日0时开始的毫秒数String≤18BelongToServices该服务项目所属的服务列表。一个相同的服务项目可能属于不同的服务，但是所属的这些服务的服务类型是相同的。BelongToServices其中，自定义复合类型BelongToServices包含如下信息：名称说明数据类型长度（字节）BelongToService服务项目和服务的隶属关系。可以出现多次。Element其中，BelongToService包含如下信息：名称说明数据类型长度（字节）ServiceID该服务项目所属的服务号码。String16OperationType操作码：01：新增该服务项目与服务的隶属关系02：删除该服务项目与服务的隶属关系String2由于服务项目数量较多，每次上传仅传送发生了变化的服务项目。定义ServiceItemUploadRequest消息的Schema格式如下：80 产品批量上传接口应答消息ServiceItemUploadResponse包含如下信息：名称说明数据类型长度（字节）SenderID互联星空系统的省份码String2ServiceResults处理结果ServiceResults80 其中，ServiceResults包含如下信息：名称说明数据类型长度（字节）ServiceResult处理结果记录，可出现多次Element其中，ServiceResult包含如下信息：名称说明数据类型长度（字节）ServiceID服务IDString16ServiceItemID服务项目IDString36Result交易结果0：成功-1001：失败Int4ErrorDescription对错误/异常的详细描述信息String≤256定义ServiceItemUploadResponse消息的Schema格式如下：80 1.1.1离线支付接口接口采用SOAP协议和HTTPS协议。接口方法为：http://ChinaVnetCenter/v1.2/OfflinePayment接口请求消息OfflinePaymentRequest包含如下信息：名称说明数据类型长度（字节）SPIDSP编码String8Authenticator认证码，用于鉴别发送者。取值=base64(SHA1(SPSecret＋TimeStamp))StringTimeStamp时间戳，从1970年1月1日0时开始的毫秒数String≤18UserID用户的唯一标识String11TransactionID交易号String36ServiceID用户消费的服务IDString16ServiceItemID服务项目IDString36ItemName服务项目名称String100Fee支付金额（以分为单位）Int4MinValue根据PaymentType取值不同具有不同的含义，String≤1880 对于PaymentType=001的包时段的离线支付类型，含义为包时段开始时间，取值为从1970年1月1日0时开始的毫秒数。MaxValue根据PaymentType取值不同具有不同的含义，对于PaymentType=001的包时段的离线支付类型，含义为包时段结束时间，取值为从1970年1月1日0时开始的毫秒数。String≤18PaymentType支付类型。目前仅支持包时段的离线支付，取值为：001。String3定义OfflinePaymentRequest的Schema格式如下：接口应答消息OfflinePaymentResponse包含信息如下:名称说明数据类型长度(字节)80 SenderID互联星空系统的省份码String2TransactionID交易号，与对应请求消息中的交易号相同String36TimeStamp时间戳，从1970年1月1日开始的毫秒数String≤18Result0:成功-1001：用户余额(信用)不足-10001：包数据格式不正确-10002：数据校验不正确Int4ErrorDescription对错误/异常的详细描述信息String≤256定义OfflinePaymentResponse的Schema格式如下：80 1附录1.1附录1－省份标识表省份码省份名称省份标识省份码省份名称省份标识01北京BJ19湖南HN02上海SH20广东GD03天津TJ21广西GX04重庆CQ22海南HI05河北HE23四川SC06山西SX24贵州GZ07内蒙古NM25云南YN08辽宁LN26西藏XZ09吉林JL27陕西SN10黑龙江HL28甘肃GS11江苏JS29青海QH12浙江ZJ30宁夏NX13安徽AH31新疆XJ14福建FJ32台湾TW15江西JX33香港HK16山东SD34澳门MO17河南HA35全国中心ZX18湖北HB36海外HW1.2附录2－编码规则1.2.1UserIDUserID的编码格式如下：省份码序列号80 其中，省份码（见附录2）代表用户所属的省，省份码为2位数字；序列号是9位的数字序列，需要保证同一省份同类用户的序列号不同。1.1.1NickName用户的昵称，其中不允许有“$”符号。1.1.2SPIDSP编码格式如下：省份码序列号其中，省份码（见附录2）代表SP接入的省，省份码为2位数字；6位数字的序列号用于标识SP。例如，某SP在广东接入，广东省份码为20，分配给某网站的序列号为××××××，则该SP的SPID为20××××××。1.1.3SPSecretSPSecret为24个字节的字符串，其内容为数值，数值采用16进制表示，由省级中心为其管理的SP自动生成。1.1.4ServiceIDServiceID为16位长的数值，其中前8位为SPID，后8位由SP自行生成，SP需要保证不同的服务，其ID不相同。1.1.5ServiceItemIDServiceID为36位长的数值，其中前16位为ServiceID，后20位由SP自行生成，SP需要保证不同的服务项目，其ID不相同。1.1.6TransactionIDTransactionID80 为36位长的数值，其中前8位为SPID，后28位由SP自行生成，SP需要保证不同的事务（用户订购或使用一次服务），其ID不相同。1.1附录3－UserProfile格式用户的授权信息UserProfle格式如下：UserProfile=AuthProfile*(","AuthProfile)其中，AuthProfle格式如下：AuthProfile="ServiceID""="value";""ServiceItemID""="value";""StartTime""="value";""EndTime""="value各属性说明如下：属性名描述ServiceID服务ID，参见附录2StartTime使用服务开始时间，从1970年1月1日0时开始的毫秒数EndTime使用服务结束时间，从1970年1月1日0时开始的毫秒数ServiceItemID服务项目ID，参见附录21.2 附录4 －服务类型的schema定义1.2.1影视80 80 80 1.1.1音乐80 80 80 80 80'