中国移动通信USSD应用接口协议10

1、中国移动通信 china mobile中国移动通信企业标准qb-xx-xxx-xxxx中国移动通信ussd应用接口协议china m o b i i e ussd a p pi i c a tion版本号：1.0.0（报批稿）xxxx-xx-xx 发布xxxx-xx-xx 实施中国移动通信集团公司 发布目录1 范围12 引用标准13 术语和定义14 ussdc与ussd业务应用的接口模型15 消息定义25.1 基本数据类型25.2 消息结构25.3 消息头格式 (message header) 25.4 业务提供商(sp)-lj ussd中心(ussdc)间的消息定义35.4.1 sp请求连接

2、到ussdc (bind)操作35.4.1.1 bind 消息定义(sptussdc) 3541.2 bind.resp 消息定义(ussdc 9 sp) 35.4.2 sp请求拆除连接(unbind)操作45.4.2.1 unbind 肖息定义(sptussdc) 45.4.2.2 unbind.resp 消息定义(ussdc -> sp) 45.4.3 sp 连接保持(enqu1re.link)操作45.4.3.1 enquirejjnk ；肖息定义(sptussdc) 55.4.3.2 enquire_link_resp 肖息定义(ussdc 7 sp) 55.4.4 开始ussd

3、会话(begin)操作55.4.4.1 begin 消息定义(spoussdc) 55.4.5 继续 ussd 会话(continue)操作65.4.5continue ;肖息的定义(spctussdc) 65.4.6 结束ussd会话(end)操作75.4.6end肖息的定义(sptussdc) 75.4.7 中止ussd会话(abort)操作85.4.7.1 abort 肖息定义(sp&tussdc) 85.4.8 ussd 会话转移(switch)操作85.4.8switch 肖息定义(sp ussdc) 85.4.9 开始转移 ussd 会话(switch_begin)操作95

4、.4.9.1 switch.begin 肖息定义(ussdcpsp) 95410计费扌旨示(charge)操作105410charge 肖息定义(spt ussdc) 1()5.4.10.2 charge_resp 肖息定义(ussdc t sp) 105.5 系统定义115.5.1 command_id 定义115.5.2 部分错课码定义116 附录1移动台发起的ussd会话流程137 附录2 sp发起的ussd会话流程138 附录3 ussd会话转移的流程149 附录4计费指示的流程1410 修订历史15ii亠 j 冃ij s木规范规定了移动ussd业务开展过程中ussdc与sp z间的消

5、息类型和定义，冃前为1. 0. 0版木。根据业务的发展，规范屮的信令操作和参数将会做进一步的调整和增加。本标准由小国移动通信集团公司技术部提出并归口。木标准起草单位：中国移动通信集团公司研发中心。本标准主要起草人：丁晓城、许炜、于蓉蓉。木标准解释单位：同提出单位。1范围本规范规定了以下内容：业务提供商与ussdc z间的接口协议;本规范适用于各sp和ussdc的开发厂商。2引用标准下列标准所包含的条文，通过在木标准屮引用而成为木标准的条文。木标准出版时，所 示版木均为冇效。所冇标准都会被修订，使川本标准的各方应探讨使用下列标准最新版本的 可能性。3术语和定义英文缩写英文全称说明ussdcuns

6、tructured supplement service ussd 中心data center4 ussdc与ussd业务应用的接口模型图1 ussdc与ussd业务应用的接口模型图5消息定义5.1基本数据类型unsigned integer无符号整数integer整数，可为正整数、负整数或零c-octet string以null结束的ascii字符串，由一系列的10进制字符 组成（o9）octet string变长字符串，不要求以null结束注意:（1）如果octet-string字段设置为null,说明该字段只有一个null字符组成。例如, 值为0x00 （零）的一个字节。（2）如果int

7、eger字段设置为null,说明该字段无值。（3）对于c-octet string格式，若没有hr说明，则表示该字段是固定长度，其有效 值为字符串加null；若冇var说明，则表示该字段为变氏，其字段大小的最大值是字 符串和null结束符长度的总和。5.2 消息结构项目说明message header消息头（所有消息公共包头）message body消息体（可选）5.3 消息头格式(message header)字段名大小（j节）类型说明command_length4unsignedinteger消息总长度（含消息头及消息体）command_id4unsignedinteger命令或消息类型c

8、ommand_status4unsignedinteger命令状态。命令状态字段表示请求 消息是否成功。该字段只用在应答 消息屮，在请求消息屮，该字段必 须为0osender_ld4unsignedinteger消息发出方会话控制标识receiver id4unsigned消息接收方会话控制标识integer5.4 业务提供商(sp)与ussd中心(ussdc)间的消息定义sp为客户端，向作为服务器端的ussdc发起连接请求，在通过身份验证z后sp与 ussdc z间方可进行数据传输。传输数据中，英文采用8位ascii编码，ussd串中的中 文采用gb2312-8()兼容的字符集。5.4.1

9、sp请求连接至lj ussdc (bind)操作bind操作的目的是sp向ussdc注册作为一个合法sp身份，若注册成功后即建立了 应用层的连接，此后sp可以通过此ussdc接收或发起ussd请求。ussdc以bind_resp消息响应sp的请求。5.4.1.1 bind 消息定义(sptussdc)字段名大小(字节)类型说明消 息 头command length4unsigned integer定义整个消息包的大小command id4unsigned integer消息标识command status4unsigned integer未使用，置为0sender id4unsigned in

10、teger未使用，置为oxffffffffreceiver_id4unsigned integer未使用，置为oxffffffffsystem_ldllc-octet string业务应用登录标识，即sp的企 业代码或登录帐号password9c-octet string业务应用的背录密码system type13c-octet string业务应川类型，此处取值ussdin terface_ version4unsigned integer双方协商的版本号(前三个字节 保留，収值为零。最后一个字节 高位4bit表示主版本号，低位4bit 表示次版本号)。例如：对于1.0 的版木，该值为oxo

11、oooooloo5.4.1.2 bind_resp 消息定义(ussdc 夕 sp)字段名人小(字节)类型说明command length4unsigned integer定义整个消息包的大小command id4unsigned integer消息标识消 息 头commandstatus4unsigned integersp注册的结果，0表示成功，其 它表示注册失败sender id4unsigned integer未使用，置为oxffffffffreceiver id4unsigned integer未使用，置为oxffffffffsystem_ld11c-octet stringussd

12、c的标识5.4.2 sp请求拆除连接（unbind）操作unbind操作的目的是sp基于某些原因决定拆除当前的应用层连接而发起的操作。此 操作完成后sp与ussdc z间的应用层连接被释放，此后sp若再要与ussdc通信时应发 起bind操作。ussdc以unbind_resp消息响应请求。5.4.2.1 unbind肖息定义(spussdc)字段名大小（字节）类型说明消 息 头command length4unsigned integer定义整个消息包的人小command id4unsigned integer消息标识command status4unsigned integer未使用，置为

13、0sender id4unsigned integer未使用，置为oxffffffffrcccivcr id4unsigned integer未使用，置为oxffffffff5.4.2.2 unbind_resp 消息定义(ussdc 9 sp)字段名大小（字节）类型说明消 息 头command length4unsigned integer定义整个消息包的人小command id4unsigned integer消息标识command status4unsigned integer未使用,置为0sender id4unsigned integer未使用，置为oxffffffffreceive

14、r id4unsigned integer未使用，置为oxffffffff5.4.3 sp 连接保持(enquirejjnk)操作enquire_link操作的目的是为了确认sp与ussdc之间的tcp连接状况。sp在登 录ussdc认证成功后，应定时（每5秒）向ussdc发送enqu1rejjnk消息，ussdc 在收到enqu1re.link消息后应向sp发送enqu1re_link_resp消息确认tcp连接状况。5.4.3.1 enquire_link ;肖息定义（sptussdc）字段名人小（字节）类型说明消 息 头command lcngth4unsigned integer定义整

15、个消息包的人小cominand id4unsigned integer消息标识command status4unsigned integer未使用，置为0sender id4unsigned integer未使用，置为oxffffffffrcccivcr id4unsigned integer未使用，置为oxffffffff5.4.3.2 enquire_link_resp 消息定义（ussdctsp）字段名人小（字节）类型说明消 息 头command length4unsigned integer定义整个消息包的大小cominand id4unsigned integer消息标识comman

16、d status4unsigned integer未使用,置为0sender id4unsigned integer耒使用，置为oxffffffffreceiver id4unsigned integer未使用，置为oxffffffff5.4.4开始ussd会话（begin）操作begin操作的h的是建立一个ussd会话，它既可以由移动台发起，也可以由sp发起。5.4.4.1 begin 消息定义（spg9ussdc）字段名人小（字节）类型说明消 息 头command length4unsigned integer定义整个消息包的大小command id4unsigned integer消息标

17、识command status4unsigned integer未使用，置为0sender_id4unsigned integer消息发出方会话控制标识，范围为：（）x（）hox7fffffffhreceiver_id4unsigned integer消息接收方会话控制标识，置 为oxffffffff消 息 体ussd_ version1unsigned integerussd会话版本号0x10： phase i0x20： phase ii0x25： phase 11+ussd_op_typelunsigned integerussd对话操作类型：0x01： pssr (ussdc->s

18、p) 或ussr (sp->ussdc) 0x02： ussn (sp->ussdc)mslsdn21c-octet string移动台号码service code21c-octet string业务接入码code_scheme1unsigned integer1、ussdc发往sp是取值为 0x44,意义可以忽略。2、sp发往ussd中心时该字段 指示ussdc对下发终端的 ussd申进行编码的格式。常用 的编码格式包括：0x0f （7位 编码）、0x11 （16位编码）、 0x44 （8位编码）ussd contentvar max 182octet stringussd串的内

19、容5.4.5 继续 ussd 会话(continue)操作continue操作的h的是继续保持sp与ussdcz间的会话，它町以由sp发出，也可以市移动台发出。5.4.5.1 continue 消息的定义（spgtussdc）字段名大小（字节）类型说明消 息 头command length4unsigned integer定义鉴个消息包的人小commandid4unsigned integer消息标识command status4unsigned integer未使用，置为0sender_id4unsigned integer消息发出方会话控制标识，范 围为：0x0h0x7fffffffhre

20、ceiver_id4unsigned integer消息接收方会话控制标识，范围为：0x0h0x7fffffffh消 息 体ussd_ version1unsigned integerussd会话版本号：0x10： phase i0x20： phase ii0x25： phase 11+要求与begin消息中保持一 致ussd_op_type1unsigned integerussd对话操作类型：0x01 ( request ) : ussr (sp->ussdc)0x02( notify ): ussn(sp->ussdc)0x03 (response): ussdc->s

21、pmslsdn2lc-octet string移动台号码，保持与begin消 息致service_code21c-octet string业务接入码，保持与begin消 息一致code_scheme1unsigned integer1、ussdc发往sp是取值为 0x44,意义可以忽略。2、sp发往ussd中心时该字段 指示ussdc对下发终端的 ussd串进行编码的格式。常用 的编码格式包括:oxof （7位 编码）、0x11 （16位编码）、 0x44 （8位编码）ussd contentvar max 182octet stringussd串的内容5.4.6结束ussd会话（end）操作

22、end操作的id的是正常释放ussd会话，它只能由sp发出。5.4.6.1 end;肖息的定义（sp9ussdc）字段名大小（字节）类型说明消 息 头command length4unsigned integer定义整个消息包的大小command ld4unsigned integer消息标识commandstatus4unsigned integer会话释放的原因sender_id4unsigned integer消息发出方会话控制标识，范围为：0x0h0x7fffffffhreceiver_id4unsigned integer消息接收方会话控制标识，范 围为：oxoh0x7fffffff

23、h消 息 体ussd_ version1unsigned integerussd会话版本号：0x10： phase i0x20： phase ii0x25： phase 11+要求与begin消息屮保持一 致ussd_op_type1unsigned integerussd对话操作类型：0x03 （response） : begin消 息由移动台发起0x04 （release） : begin消息 由sp发起mslsdn21c-octet string移动台号码，保持与begin消 息一致service_code21c-octet string业务接入码，保持与begin消息一致cocle_s

24、chemelunsigned integerl > ussdc发往sp是取值为 0x44,意义可以忽略。2、sp发往ussd中心时该字段 指示ussdc对卜-发终端的 ussd串进行编码的格式。常用 的编码格式包括：oxof （7位 编码）、0x11 （16位编码）、 0x44 （8位编码）ussd contentvar max 182octet stringussd串的内容5.4.7中止ussd会话（abort）操作abort操作的口的是界常释放ussd会话，它可以由sp发出，也可以由移动台发岀。5.4.7.1 abort 肖息定义(spgtussdc)字段名大小（字节）类型说明消 息

25、 头cominand length4unsigned integer定义整个消息包的大小command id4unsigned integer消息标识command status4unsigned integer会话界常释放的原因sender_id4unsigned integer消息发出方会话控制标识，范围 为:oxoh0x7fffffffhreceiver_id4unsigned integer消息接收方会话控制标识，范围为：（）x（）h0x7fffffffh5.4.8 ussd会话转移（switch）操作switch用于begin由移动台发起的会话，它将ussd会话从一个sp1转移到另一

26、个 sp2。当sp1发出switch后应释放当前对话的本地资源，ussdc收到switch后将关闭 与sp1的对话分支，然后少switch指定的业务sp2建立会话，ussdc为移动台z间的会 话仍然保持，后续的ussd会话交互在移动台与sp2 z间进行。5.4.&1 switch 消息定义（sp 夕 ussdc）字段名大小（字节）类型说明消 息 头command length4unsigned integer定义整个消息包的大小command id4unsigned integer消息标识command suitus4unsigned integer未使用，置为0sender_id4u

27、nsigned integer消息发出方会话控制标识，范 围为：（）x（）h（）x7fffffffhreceiver_id4unsigned integer消息接收方会话控制标识，范围为：0x0h0x7fffffffh消 息 体switch_mode1unsigned integer转移模式：0：全局转移1：木地转移mslsdn21c-octet string移动台号码，保持与begin消 息-致org_service_code21c-octet string源业务接入码或业务菜单位 置信息dest_ service_code21c-octet string转移的目的业务接入码或业 务菜单位査

28、信息ussd contcntvar max 182octet stringussd串的内容5.4.9开始转移ussd会话(switchbegin)操作switch.begin操作的目的是在ussdc收到源sp发送的switch消息后，与目的sp建立一个ussd会话，由ussdc发给冃的sp。5.4.9.1 switch_begin 肖息定义（ussdctsp）字段名大小(字节)类型说明消 息 头command length4unsigned integer定义整个消息包的大小command id4unsigned integer消息标识cominand status4unsigned inte

29、ger未使用，置为0sender_id4unsigned integer消息发出方会话控制标识，范 围为：()x()h()x7fffffffhreceiver_id4unsigned integer消息接收方会话控制标识，置 为oxffffffff消 息 体ussd_vcrsion1unsigned integerussd会话版木号0x10： phase i0x20： phase ii0x25： phase 11+ussd_op_type1unsigned integerussd对话操作类型：0x01:表示requestmslsdn21c-octet string移动台号码org_servic

30、e_code21c-octet string源业务接入码或业务菜单位 置信息dest_ service_code21c-octet string转移的目的业务接入码或业 务菜单位置信息code_scheme1unsigned integer该字段填写0x44,意义口j以忽 略；ussd contentvar max 182octet stringussd串的内容5.4.10 计费指示(charge)操作charge川于sp请求ussdc进行计费，ussdc发送charge_resp消息返回计费结果。5.4.10.1 charge 肖息定义(sp ussdc)字段名人小（字节）类型说明消 息 头

31、cominand length4unsigned integer定义整个消息包的大小command id4unsigned integer消息标识commandstatus4unsigned integer未使用，置为0scndcr_id4unsigned integer消息发出方会话控制标识，范 围为：oxoh0x7fffffffhreceiver_id4unsigned integer消息接收方会话控制标识，范i韦i 为：（）x（）h（）x7fffffffh消 息 体charge ratio4unsigned integer计费费率，单位为分charge_type4unsigned int

32、eger计费类型： 0 免费1 按条2 包月计费3-包月下行 4按时长charge_resource21c-octet string计费源标识,由sp企业代码与业务代码组成charge_location1unsigned integer计费地点：0x01ussd中心与 ussd业务网关均产生计费话 单,0x02-仅ussd中心产生计 费话单，0x03-仅ussd业务网 关产生话单5.4.10.2 charge_resp 消息定义(ussdc t sp)字段名人小（字节）类型说明消 息 头command length4unsigned integer定义整个消息包的大小command id4un

33、signed integer消息标识command_status4unsigned integer计费结果：0：成功其它：失败sender_id4unsigned integer消息发出方会话控制标识，范围 为：oxoh0x7fffffffhreceiver_id4unsigned integer消息接收方会话控制标识，范围 为:oxoh0x7fffffffh5.5 系统定义5.5.1 commandd 定义消息command id 值说明bind()x()000()065请求连接bind resp0x00000067请求连接应答unbind0x00000066终止连接unbind resp0

34、x00000068终止连接应答enqu1re.l1nk0x00000083握手请求enquire link resp0x()()()0()084握手应答begin0x0000006f开始ussd会话continue0x00000070继续ussd会话end0x00000071结束ussd会话abort0x00000072中止ussd会话switch0x00000074ussd会话转移chargeind0x00000075计费指示chargeind resp0x00000076计费指示应答switch.begin0x00000077开始转移ussd会话5.5.2部分错误码定义错误码描述0成功20

35、00非法的sp id2001错误的认证信息2003已达系统支持的最大ussd会话数2004ussd会话不存在2005会话转移失败2006等待移动台侧响应超吋2007等待应用服务器响应超时2008整个会话超时2009没有匹配路由2010ussd会话版本错误2011ussd会话类型错误2012ussd content格式错误2013业务接入码错课2014非法用户2015应用服务器发起对话时， map open打开失败2016应用服务器发起对话时，map.open对话被拒绝qbxxxxxxxxx2017移动台中途挂机2018移动台连接网络故障2019uap版木太高2020用户余额不足2021无业务信

36、息附录1移动台发起的ussd会话流程sp连接处理ussdcbindbind_respbegin(request)continue(request)continue(response)会话处理continue(notify)continue(response)end(response)unbindunbind resp拆除连接附录2 sp发起的ussd会话流程ussdcbindbind_resp连接处理begin(request)continue(response)continue(notify)会话处理continue(response)end(rclcasc)vunbindunbind_resp>拆除连接附录3 ussd会话转移的流程ussdcsp1sp2begin(request)switch_begin(rcqucst)continue(request)contin u 玖 response)switchcontinue(request)continue(response