中國移動通信USSD應(yīng)用接口協(xié)議10

1、中國移動通信 china mobile中國移動通信企業(yè)標準qb-xx-xxx-xxxx中國移動通信ussd應(yīng)用接口協(xié)議china m o b i i e ussd a p pi i c a tion版本號：1.0.0（報批稿）xxxx-xx-xx 發(fā)布xxxx-xx-xx 實施中國移動通信集團公司 發(fā)布目錄1 范圍12 引用標準13 術(shù)語和定義14 ussdc與ussd業(yè)務(wù)應(yīng)用的接口模型15 消息定義25.1 基本數(shù)據(jù)類型25.2 消息結(jié)構(gòu)25.3 消息頭格式 (message header) 25.4 業(yè)務(wù)提供商(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 繼續(xù) ussd 會話(continue)操作65.4.5continue ;肖息的定義(spctussdc) 65.4.6 結(jié)束ussd會話(end)操作75.4.6end肖息的定義(sptussdc) 75.4.7 中止ussd會話(abort)操作85.4.7.1 abort 肖息定義(sp&tussdc) 85.4.8 ussd 會話轉(zhuǎn)移(switch)操作85.4.8switch 肖息定義(sp ussdc) 85.4.9 開始轉(zhuǎn)移 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 系統(tǒng)定義115.5.1 command_id 定義115.5.2 部分錯課碼定義116 附錄1移動臺發(fā)起的ussd會話流程137 附錄2 sp發(fā)起的ussd會話流程138 附錄3 ussd會話轉(zhuǎn)移的流程149 附錄4計費指示的流程1410 修訂歷史15ii亠 j 冃ij s木規(guī)范規(guī)定了移動ussd業(yè)務(wù)開展過程中ussdc與sp z間的消

5、息類型和定義，冃前為1. 0. 0版木。根據(jù)業(yè)務(wù)的發(fā)展，規(guī)范屮的信令操作和參數(shù)將會做進一步的調(diào)整和增加。本標準由小國移動通信集團公司技術(shù)部提出并歸口。木標準起草單位：中國移動通信集團公司研發(fā)中心。本標準主要起草人：丁曉城、許煒、于蓉蓉。木標準解釋單位：同提出單位。1范圍本規(guī)范規(guī)定了以下內(nèi)容：業(yè)務(wù)提供商與ussdc z間的接口協(xié)議;本規(guī)范適用于各sp和ussdc的開發(fā)廠商。2引用標準下列標準所包含的條文，通過在木標準屮引用而成為木標準的條文。木標準出版時，所 示版木均為冇效。所冇標準都會被修訂，使川本標準的各方應(yīng)探討使用下列標準最新版本的 可能性。3術(shù)語和定義英文縮寫英文全稱說明ussdcuns

6、tructured supplement service ussd 中心data center4 ussdc與ussd業(yè)務(wù)應(yīng)用的接口模型圖1 ussdc與ussd業(yè)務(wù)應(yīng)用的接口模型圖5消息定義5.1基本數(shù)據(jù)類型unsigned integer無符號整數(shù)integer整數(shù)，可為正整數(shù)、負整數(shù)或零c-octet string以null結(jié)束的ascii字符串，由一系列的10進制字符 組成（o9）octet string變長字符串，不要求以null結(jié)束注意:（1）如果octet-string字段設(shè)置為null,說明該字段只有一個null字符組成。例如, 值為0x00 （零）的一個字節(jié)。（2）如果int

7、eger字段設(shè)置為null,說明該字段無值。（3）對于c-octet string格式，若沒有hr說明，則表示該字段是固定長度，其有效 值為字符串加null；若冇var說明，則表示該字段為變氏，其字段大小的最大值是字 符串和null結(jié)束符長度的總和。5.2 消息結(jié)構(gòu)項目說明message header消息頭（所有消息公共包頭）message body消息體（可選）5.3 消息頭格式(message header)字段名大?。╦節(jié)）類型說明command_length4unsignedinteger消息總長度（含消息頭及消息體）command_id4unsignedinteger命令或消息類型c

8、ommand_status4unsignedinteger命令狀態(tài)。命令狀態(tài)字段表示請求 消息是否成功。該字段只用在應(yīng)答 消息屮，在請求消息屮，該字段必 須為0osender_ld4unsignedinteger消息發(fā)出方會話控制標識receiver id4unsigned消息接收方會話控制標識integer5.4 業(yè)務(wù)提供商(sp)與ussd中心(ussdc)間的消息定義sp為客戶端，向作為服務(wù)器端的ussdc發(fā)起連接請求，在通過身份驗證z后sp與 ussdc z間方可進行數(shù)據(jù)傳輸。傳輸數(shù)據(jù)中，英文采用8位ascii編碼，ussd串中的中 文采用gb2312-8()兼容的字符集。5.4.1

9、sp請求連接至lj ussdc (bind)操作bind操作的目的是sp向ussdc注冊作為一個合法sp身份，若注冊成功后即建立了 應(yīng)用層的連接，此后sp可以通過此ussdc接收或發(fā)起ussd請求。ussdc以bind_resp消息響應(yīng)sp的請求。5.4.1.1 bind 消息定義(sptussdc)字段名大小(字節(jié))類型說明消 息 頭command length4unsigned integer定義整個消息包的大小command id4unsigned integer消息標識command status4unsigned integer未使用，置為0sender id4unsigned in

10、teger未使用，置為oxffffffffreceiver_id4unsigned integer未使用，置為oxffffffffsystem_ldllc-octet string業(yè)務(wù)應(yīng)用登錄標識，即sp的企 業(yè)代碼或登錄帳號password9c-octet string業(yè)務(wù)應(yīng)用的背錄密碼system type13c-octet string業(yè)務(wù)應(yīng)川類型，此處取值ussdin terface_ version4unsigned integer雙方協(xié)商的版本號(前三個字節(jié) 保留，収值為零。最后一個字節(jié) 高位4bit表示主版本號，低位4bit 表示次版本號)。例如：對于1.0 的版木，該值為oxo

11、oooooloo5.4.1.2 bind_resp 消息定義(ussdc 夕 sp)字段名人小(字節(jié))類型說明command length4unsigned integer定義整個消息包的大小command id4unsigned integer消息標識消 息 頭commandstatus4unsigned integersp注冊的結(jié)果，0表示成功，其 它表示注冊失敗sender id4unsigned integer未使用，置為oxffffffffreceiver id4unsigned integer未使用，置為oxffffffffsystem_ld11c-octet stringussd

12、c的標識5.4.2 sp請求拆除連接（unbind）操作unbind操作的目的是sp基于某些原因決定拆除當前的應(yīng)用層連接而發(fā)起的操作。此 操作完成后sp與ussdc z間的應(yīng)用層連接被釋放，此后sp若再要與ussdc通信時應(yīng)發(fā) 起bind操作。ussdc以unbind_resp消息響應(yīng)請求。5.4.2.1 unbind肖息定義(spussdc)字段名大小（字節(jié)）類型說明消 息 頭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)字段名大?。ㄗ止?jié)）類型說明消 息 頭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認證成功后，應(yīng)定時（每5秒）向ussdc發(fā)送enqu1rejjnk消息，ussdc 在收到enqu1re.link消息后應(yīng)向sp發(fā)送enqu1re_link_resp消息確認tcp連接狀況。5.4.3.1 enquire_link ;肖息定義（sptussdc）字段名人小（字節(jié)）類型說明消 息 頭command lcngth4unsigned integer定義整

15、個消息包的人小cominand id4unsigned integer消息標識command status4unsigned integer未使用，置為0sender id4unsigned integer未使用，置為oxffffffffrcccivcr id4unsigned integer未使用，置為oxffffffff5.4.3.2 enquire_link_resp 消息定義（ussdctsp）字段名人?。ㄗ止?jié)）類型說明消 息 頭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會話，它既可以由移動臺發(fā)起，也可以由sp發(fā)起。5.4.4.1 begin 消息定義（spg9ussdc）字段名人?。ㄗ止?jié)）類型說明消 息 頭command length4unsigned integer定義整個消息包的大小command id4unsigned integer消息標

17、識command status4unsigned integer未使用，置為0sender_id4unsigned integer消息發(fā)出方會話控制標識，范圍為：（）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業(yè)務(wù)接入碼code_scheme1unsigned integer1、ussdc發(fā)往sp是取值為 0x44,意義可以忽略。2、sp發(fā)往ussd中心時該字段 指示ussdc對下發(fā)終端的 ussd申進行編碼的格式。常用 的編碼格式包括：0x0f （7位 編碼）、0x11 （16位編碼）、 0x44 （8位編碼）ussd contentvar max 182octet stringussd串的內(nèi)

19、容5.4.5 繼續(xù) ussd 會話(continue)操作continue操作的h的是繼續(xù)保持sp與ussdcz間的會話，它町以由sp發(fā)出，也可以市移動臺發(fā)出。5.4.5.1 continue 消息的定義（spgtussdc）字段名大?。ㄗ止?jié)）類型說明消 息 頭command length4unsigned integer定義鑒個消息包的人小commandid4unsigned integer消息標識command status4unsigned integer未使用，置為0sender_id4unsigned integer消息發(fā)出方會話控制標識，范 圍為：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業(yè)務(wù)接入碼，保持與begin消 息一致code_scheme1unsigned integer1、ussdc發(fā)往sp是取值為 0x44,意義可以忽略。2、sp發(fā)往ussd中心時該字段 指示ussdc對下發(fā)終端的 ussd串進行編碼的格式。常用 的編碼格式包括:oxof （7位 編碼）、0x11 （16位編碼）、 0x44 （8位編碼）ussd contentvar max 182octet stringussd串的內(nèi)容5.4.6結(jié)束ussd會話（end）操作

22、end操作的id的是正常釋放ussd會話，它只能由sp發(fā)出。5.4.6.1 end;肖息的定義（sp9ussdc）字段名大小（字節(jié)）類型說明消 息 頭command length4unsigned integer定義整個消息包的大小command ld4unsigned integer消息標識commandstatus4unsigned integer會話釋放的原因sender_id4unsigned integer消息發(fā)出方會話控制標識，范圍為：0x0h0x7fffffffhreceiver_id4unsigned integer消息接收方會話控制標識，范 圍為：oxoh0x7fffffff

23、h消 息 體ussd_ version1unsigned integerussd會話版本號：0x10： phase i0x20： phase ii0x25： phase 11+要求與begin消息屮保持一 致ussd_op_type1unsigned integerussd對話操作類型：0x03 （response） : begin消 息由移動臺發(fā)起0x04 （release） : begin消息 由sp發(fā)起mslsdn21c-octet string移動臺號碼，保持與begin消 息一致service_code21c-octet string業(yè)務(wù)接入碼，保持與begin消息一致cocle_s

24、chemelunsigned integerl > ussdc發(fā)往sp是取值為 0x44,意義可以忽略。2、sp發(fā)往ussd中心時該字段 指示ussdc對卜-發(fā)終端的 ussd串進行編碼的格式。常用 的編碼格式包括：oxof （7位 編碼）、0x11 （16位編碼）、 0x44 （8位編碼）ussd contentvar max 182octet stringussd串的內(nèi)容5.4.7中止ussd會話（abort）操作abort操作的口的是界常釋放ussd會話，它可以由sp發(fā)出，也可以由移動臺發(fā)岀。5.4.7.1 abort 肖息定義(spgtussdc)字段名大?。ㄗ止?jié)）類型說明消 息

25、 頭cominand length4unsigned integer定義整個消息包的大小command id4unsigned integer消息標識command status4unsigned integer會話界常釋放的原因sender_id4unsigned integer消息發(fā)出方會話控制標識，范圍 為:oxoh0x7fffffffhreceiver_id4unsigned integer消息接收方會話控制標識，范圍為：（）x（）h0x7fffffffh5.4.8 ussd會話轉(zhuǎn)移（switch）操作switch用于begin由移動臺發(fā)起的會話，它將ussd會話從一個sp1轉(zhuǎn)移到另一

26、個 sp2。當sp1發(fā)出switch后應(yīng)釋放當前對話的本地資源，ussdc收到switch后將關(guān)閉 與sp1的對話分支，然后少switch指定的業(yè)務(wù)sp2建立會話，ussdc為移動臺z間的會 話仍然保持，后續(xù)的ussd會話交互在移動臺與sp2 z間進行。5.4.&1 switch 消息定義（sp 夕 ussdc）字段名大小（字節(jié)）類型說明消 息 頭command length4unsigned integer定義整個消息包的大小command id4unsigned integer消息標識command suitus4unsigned integer未使用，置為0sender_id4u

27、nsigned integer消息發(fā)出方會話控制標識，范 圍為：（）x（）h（）x7fffffffhreceiver_id4unsigned integer消息接收方會話控制標識，范圍為：0x0h0x7fffffffh消 息 體switch_mode1unsigned integer轉(zhuǎn)移模式：0：全局轉(zhuǎn)移1：木地轉(zhuǎn)移mslsdn21c-octet string移動臺號碼，保持與begin消 息-致org_service_code21c-octet string源業(yè)務(wù)接入碼或業(yè)務(wù)菜單位 置信息dest_ service_code21c-octet string轉(zhuǎn)移的目的業(yè)務(wù)接入碼或業(yè) 務(wù)菜單位査

28、信息ussd contcntvar max 182octet stringussd串的內(nèi)容5.4.9開始轉(zhuǎn)移ussd會話(switchbegin)操作switch.begin操作的目的是在ussdc收到源sp發(fā)送的switch消息后，與目的sp建立一個ussd會話，由ussdc發(fā)給冃的sp。5.4.9.1 switch_begin 肖息定義（ussdctsp）字段名大小(字節(jié))類型說明消 息 頭command length4unsigned integer定義整個消息包的大小command id4unsigned integer消息標識cominand status4unsigned inte

29、ger未使用，置為0sender_id4unsigned integer消息發(fā)出方會話控制標識，范 圍為：()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源業(yè)務(wù)接入碼或業(yè)務(wù)菜單位 置信息dest_ service_code21c-octet string轉(zhuǎn)移的目的業(yè)務(wù)接入碼或業(yè) 務(wù)菜單位置信息code_scheme1unsigned integer該字段填寫0x44,意義口j以忽 略；ussd contentvar max 182octet stringussd串的內(nèi)容5.4.10 計費指示(charge)操作charge川于sp請求ussdc進行計費，ussdc發(fā)送charge_resp消息返回計費結(jié)果。5.4.10.1 charge 肖息定義(sp ussdc)字段名人小（字節(jié)）類型說明消 息 頭

31、cominand length4unsigned integer定義整個消息包的大小command id4unsigned integer消息標識commandstatus4unsigned integer未使用，置為0scndcr_id4unsigned integer消息發(fā)出方會話控制標識，范 圍為：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企業(yè)代碼與業(yè)務(wù)代碼組成charge_location1unsigned integer計費地點：0x01ussd中心與 ussd業(yè)務(wù)網(wǎng)關(guān)均產(chǎn)生計費話 單,0x02-僅ussd中心產(chǎn)生計 費話單，0x03-僅ussd業(yè)務(wù)網(wǎng) 關(guān)產(chǎn)生話單5.4.10.2 charge_resp 消息定義(ussdc t sp)字段名人?。ㄗ止?jié)）類型說明消 息 頭command length4unsigned integer定義整個消息包的大小command id4un

33、signed integer消息標識command_status4unsigned integer計費結(jié)果：0：成功其它：失敗sender_id4unsigned integer消息發(fā)出方會話控制標識，范圍 為：oxoh0x7fffffffhreceiver_id4unsigned integer消息接收方會話控制標識，范圍 為:oxoh0x7fffffffh5.5 系統(tǒng)定義5.5.1 commandd 定義消息command id 值說明bind()x()000()065請求連接bind resp0x00000067請求連接應(yīng)答unbind0x00000066終止連接unbind resp0

34、x00000068終止連接應(yīng)答enqu1re.l1nk0x00000083握手請求enquire link resp0x()()()0()084握手應(yīng)答begin0x0000006f開始ussd會話continue0x00000070繼續(xù)ussd會話end0x00000071結(jié)束ussd會話abort0x00000072中止ussd會話switch0x00000074ussd會話轉(zhuǎn)移chargeind0x00000075計費指示chargeind resp0x00000076計費指示應(yīng)答switch.begin0x00000077開始轉(zhuǎn)移ussd會話5.5.2部分錯誤碼定義錯誤碼描述0成功20

35、00非法的sp id2001錯誤的認證信息2003已達系統(tǒng)支持的最大ussd會話數(shù)2004ussd會話不存在2005會話轉(zhuǎn)移失敗2006等待移動臺側(cè)響應(yīng)超吋2007等待應(yīng)用服務(wù)器響應(yīng)超時2008整個會話超時2009沒有匹配路由2010ussd會話版本錯誤2011ussd會話類型錯誤2012ussd content格式錯誤2013業(yè)務(wù)接入碼錯課2014非法用戶2015應(yīng)用服務(wù)器發(fā)起對話時， map open打開失敗2016應(yīng)用服務(wù)器發(fā)起對話時，map.open對話被拒絕qbxxxxxxxxx2017移動臺中途掛機2018移動臺連接網(wǎng)絡(luò)故障2019uap版木太高2020用戶余額不足2021無業(yè)務(wù)信

36、息附錄1移動臺發(fā)起的ussd會話流程sp連接處理ussdcbindbind_respbegin(request)continue(request)continue(response)會話處理continue(notify)continue(response)end(response)unbindunbind resp拆除連接附錄2 sp發(fā)起的ussd會話流程ussdcbindbind_resp連接處理begin(request)continue(response)continue(notify)會話處理continue(response)end(rclcasc)vunbindunbind_resp>拆除連接附錄3 ussd會話轉(zhuǎn)移的流程ussdcsp1sp2begin(request)switch_begin(rcqucst)continue(request)contin u 玖 response)switchcontinue(request)continue(response