中国移动流量充值接口规范v1.2全解

《中国移动流量充值接口规范v1.2全解》由会员分享，可在线阅读，更多相关《中国移动流量充值接口规范v1.2全解（16页珍藏版）》请在装配图网上搜索。

1、产品名称Product name密级Confidentiality level内部公开产品版本Product versionTotal 8pages 共8页V1.00接口规范Prepared by 拟制王新Date日期2015-04-16Reviewed by 评审人Date日期yyyy-mm-ddApproved by批准Date日期yyyy-mm-ddHuawei Technologies Co., Ltd. 华为技术有限公司All rights reserved版权所有 侵权必究（for internal use only）（仅供内部使用）Revision Record 修订记录Date

2、日期Revision Version修订版本CR ID CR号Sec No. 修改章节Change Description修改描述Author作者2015-04-161.00initial 初稿完成王新目录Revision Record 修订记录21介绍41.1范围42参考文档53总体规范63.1消息结构63.1.1Message Header63.1.2Service Content83.2接口方式83.2.1协议84外围平台与BOSS接口104.1流量赠送104.1.1业务功能104.1.2业务属性104.1.3交易属性104.1.4交易报文105附录115.1渠道编码115.2地区编码1

3、15.3品牌编码125.4应用域编码125.5业务交易代码125.6应答类型及应答编码131 介绍1.1 范围本接口规范描述一级BOSS枢纽、省BOSS间关于跨区服务业务接口操作，包括其功能、流程和相关交易的接口报文定义，业务提供范围和有关受理规定请参见参考文档。2 参考文档中国移动有限公司一级BOSS接口规范_总体架构和系统管理分册v1.4.53 总体规范3.1 消息结构交易在机构和枢纽之间的消息(包括请求和应答)是以XML格式表达的。消息包括两个部分：Message Header(消息头)与Service Content(交易业务内容)；其中Message Header用于存储交易请求以及

4、应答的公共部分和消息的控制数据，而Service Content作为Message Header的最后一个Element（元素），包含交易请求和应答的业务数据。在本文档中以表格的形式表示XML格式；以下为表格中对元素约束（出现次数）的表示方法的描述：符号含义?0.1，可选项*0.n，可以没有，也可以有多项+1.n，至少有1项，也可以有多项1数字1，代表必须且只能填1项Chioce节点，同一个父结点的多个Choice节点必须且只能填一项3.1.1 Message Header根据XML的定义，每个XML文件需要有特定的Root Tag（根标记），在一级BOSS枢纽的Message Header的

5、Root Tag为“InterBOSS”.各个字段解释如下表，各机构在实现时可使用枢纽定义下发的XSD文件：表：一级BOSS枢纽与机构之间交互的统一消息格式序号父元素名称元素名称约束类型长度描述取值说明1InterBOSSOrigDomain1StringF4发起方应用域代码参见应用域编码表2InterBOSSHomeDomain1StringF4归属方应用域代码参见应用域编码表3InterBOSSBIPCode1StringF8业务功能代码参见业务交易代码表4InterBOSSActionCode1StringF1交易动作代码0：请求，1：应答5InterBOSSProcID1StringV

6、30业务流水号发起方填写的包含此交易业务的流水号6InterBOSSTransIDO1StringV30发起方交易流水号在发起方唯一标识一个交易的流水号，系统内唯一7InterBOSSTransIDH?StringV30归属方交易流水号请求中不填，由落地方在应答中填，系统内唯一8InterBOSSProcessTime1StringF14处理时间发起方发起请求的时间/应答方处理请求的时间YYYYMMDDHHMMSS9InterBOSSResponse?应答/错误信息请求中不填，应答中填9.1ResponseRspType1StringF1应答/错误类型应答或错误类型，参见应答类型及应答编码表9

7、.2ResponseRspCode1StringF4应答/错误代码应答或错误代码，参见应答/错误代码表9.3ResponseRspDesc1StringV128应答/错误描述应答或错误描述10InterBOSSSvcCont1String请求/应答内容XML格式的字符串，以CDATA区表达3.1.2 Service ContentService Content为交易请求以及应答的内容，以XML格式存储，在交易报文传输时作为Message Header的一个元素“SvcCont”和Header一起传输。为了方便各个交易实体处理和校验Serivice Content，在此元素中以常量（包含XML

8、TAG）即CDATA形式存在。另外由于Header中包含Service Content中的公共部分内容如应答码等，在有些交易的请求或者应答报文中的Service Content可能为空，对于存储转发类交易，其应答的Service Content为空。3.2 接口方式3.2.1 协议接口协议使用HTTP协议，下游节点为上游节点提供访问的URL，上游节点使用HTTP POST方法发送请求报文并得到应答报文，上游节点作为下游节点的HTTP客户端，下游节点作为上游节点的HTTP服务器。需要说明的是，在HTTP传输过程中，HTTP Header部分需要遵循下面的约定content-type= appli

9、cation/x-www-form-urlencoded；HTTP Body部分需要遵循下面的约定，即机构发送给枢纽时，要使用post方式，通过http协议进行发送，编码方式要采用utf-8。发送报文要放在http的Body属性里面，Body为$xmldata=报文内容；枢纽发送给机构时，Body为xmldata=报文内容。4 外围平台与BOSS接口4.1 流量赠送4.1.1 业务功能集团赠送。4.1.2 业务属性业务编码：ZSB00014.1.3 交易属性 交易代码：ZST00014.1.4 交易报文1、请求报文SvcCont序号父元素名称元素名称约束类型宽度描述取值说明1InterBOSS

10、SvcCont1String请求内容XML格式的字符串，以CDATA区表达1.1SvcContBizProcReq1传送请求1.1.1BizProcReqGROUPNO1StringV32集团编码1.1.2BizProcReqGrpsubsid1StringV32集团用户号1.1.3BizProcReqMSISDN1StringV11受赠手机号码1.1.4BizProcReqFLUXAMT1StringV3赠送流量10MSN-10M省内流量10M-10M全国流量赠送流量说明文档：交易模拟报文：OUTERBOSSZSB0001ZST00010596728201508071456190000000

11、1596728201508071456190000000220150807145619311A14000531121080185731833012576610M2、应答报文SvcCont无5 附录5.1 赠送流量FLUXAMT给成员赠送对应的优惠流量值10MSN10M省内20MSN20M省内30MSN30M省内50MSN50M省内70MSN70M省内100MSN100M省内150MSN150M省内200MSN200M省内300MSN300M省内500MSN500M省内1024MSN1024M省内2048MSN2048M省内10M10M国内20M20M国内30M30M国内50M50M国内70M7

12、0M国内100M100M国内150M150M国内200M200M国内300M300M国内500M500M国内1024M1024M国内2048M2048M国内5.2 渠道编码编码说明5.3 地区编码编码说明1.1.1.1.5.4 品牌编码编码说明01全球通02神州行03动感地带09其它品牌5.5 应用域编码编码说明BOSSBOSSOUTER外围平台5.6 业务交易代码编码说明5.7 应答类型及应答编码应答类型和应答码存在于应答报文的Message Header中，在交易处理过程中参与交易转发和处理的各个环节会在处理过程中产生不同类型的应答码返回给上游节点进行相应处理，可产生应答码的环节包括，发起方接入的交换节点，交换中心，以及落地方接入的交换节点和落地方机构，在产生应答时分为两级结构：应答类型和应答代码，其中应答类型为一位代码，表示交易是否成功以及产生错误的类型，而应答代码为4位，其中第一位为此错误代码的所代表错误的业务类型，即业务CLUSTER代码，其他三位为实际的错误代码，另外在定义错误类型和错误代码后，错误的产生方可以在错误描述中填写更进一步的详细信息，以下为系统产生的应答代码：错误类型及编码应答代码描述应答描述内容成功：00000交易成功则无需错误的簇代码，规定为0无系统以及交换错误：1