中国移动USSD应用接口协议.docx
《中国移动USSD应用接口协议.docx》由会员分享，可在线阅读，更多相关《中国移动USSD应用接口协议.docx（28页珍藏版）》请在冰豆网上搜索。
中国移动USSD应用接口协议
编号：
_______________
本资料为word版本，可以直接编辑和打印，感谢您的下载
中国移动USSD应用接口协议
甲方：
___________________
乙方：
___________________
日期：
___________________
说明：
本合同资料适用于约定双方经过谈判、协商而共同承认、共同遵守的责任与义务，同时阐述确定的时间内达成约定的承诺结果。
文档可直接下载或修改，使用时请详细阅读内容。
CHINAMO6JLE
中国移动通信企业标准
QB-XX-XXX-XXXX
中国移动通信
USSD应用接口协议
点对点应答
XXXX-XX-XX发布
XXXX-XX-XX实施
中国移动通信集团公司发布
1范围1
2引用标准1
3术语和定义1
4USSDC与USSD业务应用的接口模型1
5消息定义2
5.1基本数据类型2
5.2消息结构2
5.3消息头格式（MessageHeadeiO2
5.4业务提供商（SP）与USSD中心（USSDC）间的消息定义2
5.4.1SP请求连接到USSDC（BIND）操作3
5.4.1.1BIND消息定义（SPUSSDC）3
5.4.1.2BIND_RESP消息定义（USSDCSP）3
5.4.2SP请求拆除连接（UNBIND）操作4
5.4.2.1UNBIND消息定义（SPUSSDC）4
5.4.2.2UNBIND_RESP消息定义（USSDCSP）4
5.4.3SP连接保持（ENQUIRE_LINK）操作4
5.4.3.1ENQUIRE_LINK消息定义（SPUSSDC）4
5.4.3.2ENQUIRE_LINK_RESP消息定义（USSDCSP）5
5.4.4开始USSD会话（BEGIN）操作5
5.4.4.1BEGIN消息定义（SPUSSDC）5
5.4.5继续USSD会话（CONTINUE）操作6
5.4.5.1CONTINUE消息的定义（SPUSSDC）6
5.4.6结束USSD会话（END）操作7
5.4.6.1END消息的定义（SPUSSDC）7
5.4.7中止USSD会话（ABORT）操作8
5.4.7.1ABORT消息定义（SPUSSDC）8
5.4.8USSD会话转移（SWITCH）操作8
5.4.8.1SWITCH消息定义（SPUSSDC）9
5.4.9开始转移USSD会话（SWITCH_BEGIN）操作9
5.4.9.1SWITCH_BEGIN消息定义（USSDCSP）9
5.4.10计费指示（CHARGE）操作10
5.4.10.1CHARGE消息定义（SPUSSDC）10
5.4.10.2CHARGE_RESP消息定义（USSDCSP）10
5.5系统定义11
5.5.1Command_Id定义11
5.5.2部分错误码定义11
6附录1移动台发起的USSD会话流程13
7附录2SP发起的USSD会话流程13
8附录3USSD会话转移的流程14
9附录4计费指示的流程15
10修订历史15
本规范规定了移动USSt＞务开展过程中USSD由SP之间的消息类型和定义，目前为1.0.0版本。
根据
业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。
本标准由中国移动通信集团公司技术部提出并归口。
本标准起草单位：
中国移动通信集团公司研发中心。
本标准主要起草人：
丁晓城
本标准解释单位：
同提出单位。
1范围
本规范规定了以下内容：
1）业务提供商与USSDCd'可的接口协议；
本规范适用于各SP和USSDC勺开发厂商。
上海贝尔阿尔卡特回答：
明白。
2引用标准
下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。
本标准出版时，所
示版本均为有效。
所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的
可能性。
上海贝尔阿尔卡特回答：
明白。
3术语和定义
英文缩写
USSDC
英文全称说明
UnstructuredSupplementServiceUSSD中心DataCenter
4USSDC与USSD业务应用的接口模型
图1USSD"USSDdk务应用的接口模型图
上海贝尔阿尔卡特回答：
满足。
5消息定义
5.1基本数据类型
UnsignedInteger
无符号整数
Integer
「整数，可为正整数、负整数或零
C-OctetString
定长字符串，位数不足时，位数不足时，补齐原则遵照中国移动相关规定
OctetString
变长字符串，不要求以NULL结束
上海贝尔阿尔卡特回答：
满足。
5.2消息结构
项目
说明
MessageHeader
消息头（所有消息公共包头）
MessageBody
消息体（可选）
上海贝尔阿尔卡特回答：
满足。
5.3消息头格式（MessageHeader）
字段名
大小
（字节）
类型
说明
Command_Length
4
UnsignedInteger
消息总长度（含消息头及消息体）
Command_ID
4
UnsignedInteger
命令或消息类型
Command_Status
4
UnsignedInteger
命令状态。
命令状态子段表示请求消息是否成功。
该字段只用在应答消息中，在请求消息中，该字段必须为0。
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识
上海贝尔阿尔卡特回答：
满足。
5.4业务提供商（SP）与USSD中心（USSDC）间的消息定义
SP为客户端，向作为服务器端的USSDC发起连接请求，在通过身份验证之后SP与
USSDC之间方可进行数据传输。
5.4.1SP请求连接到USSDC（BIND）操作
BIND操作的目的是SP向USSDC注册作为一个合法SP身份，若注册成功后即建立了应用层的连接，此后SP可以通过此USSDC接收或发起USSD请求。
USSDC以BIND_RESP消息响应SP的请求。
5.4.1.1BIND消息定义（SPUSSDC）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
Receiver_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
System_ID
11
C-OctetString
业务应用登录标识，即SP的企业代码或登录帐号
Password
9
C-OctetString
业务应用的登录密码
System_Type
13
C-OctetString
业务应用类型，此处取值USSD
Interface_Version
4
UnsignedInteger
双方协商的版本号（高位4bit表示主版本号，低位4bit表示次版本号），对于1.0的版本，高4bit为1,低4位为0
5.4.1.2BIND_RESP消息定义（USSDCSP）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
H
Command_Status
4
UnsignedInteger
0:
正确
1:
非法SP_ID
2:
认证错
3:
版本太局
4:
其他错误
Sender_ID
4
UnsignedInteger
未使用，置为OxFFFFFFFF
Receiver_ID
4
UnsignedInteger
未使用，置为OxFFFFFFFF
System_ID
11
C-OctetString
USSDC的标识
上海贝尔阿尔卡特回答：
满足。
5.4.2SP请求拆除连接（UNBIND）操作
UNBIND操作的目的是SP基于某些原因决定拆除当前的应用层连接而发起的操作。
此
操作完成后SP与USSDC之间的应用层连接被释放，此后SP若再要与USSDC通信时应发起BIND操作。
USSDC以UNBIND_RESP消息响应请求。
5.4.2.1UNBIND消息定义（SPUSSDC）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
Receiver_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
5.4.2.2UNBIND_RESP消息定义（USSDCSP）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
Receiver_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
上海贝尔阿尔卡特回答：
满足。
5.4.3SP连接保持（ENQUIRE_LINK）操作
ENQUIRE_LINK操作的目的是为了确认SP与USSDC之间的TCP连接状况。
SP在登录USSDC认证成功后，应定时（每5秒）向USSDC发送ENQUIRE_LINK消息，USSDC在收到ENQUIRE_LINK消息后应向SP发送ENQUIRE_LINK_RESP消息确认TCP连接状况。
5.4.3.1ENQUIRE_LINK消息定义（SPUSSDC）
字段名
大小（字节）
类型
说明
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
消
Command_Status
4
UnsignedInteger
未使用，置为0
息
Sender_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
头
Receiver_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
5.4.3.2ENQUIRE_LINK_RESP消息定义（USSDCSP）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
Receiver_ID
4
UnsignedInteger
未使用，置为0XFFFFFFFF
上海贝尔阿尔卡特回答：
满足。
5.4.4开始USSD会话（BEGIN）操作
BEGIN操作的目的是建立一个USSD会话，它既可以由移动台发起，也可以由SP发
起。
5.4.4.1BEGIN消息定义（SPUSSDC）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
CommandID11—
4
UnsignedInteger
消息标识
rn
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范
围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，置
为OxFFFFFFFF
消息体
Ussd_Version
B
1
UnsignedInteger
USSD会话版本号
0x10:
PHASEI
0x20:
PHASEII
0x25:
PHASEII+
Ussd_Op_Type
1
UnsignedInteger
USSD对话操作类型：
0x01:
PSSR（USSDC->SP）或USSR（SP->USSDC）
0x02:
USSN（SP->USSDC）
MsIsdn
21
C-OctetString
移动台号码
Service_Code
21
C-OctetString
业务接入码（查到菜单级）
Code_Scheme
1
UnsignedInteger
USSD串内容的编码方案：
1、USSD中心发往SP寸该字段填与0x44，表不'8位编码；
2、SP发往USSD中心时该字段指示USSDC对Ussd_Content进行编码的格式，此时Ussd_Content本身的内容为8位编码。
常用的编码格式包
括：
0x0F（7位编码）、0x11
（16位编码）、0x44（8位编
码）
Ussd_Content
VarMax182
OctetString
USSD串的内容
上海贝尔阿尔卡特回答：
满足。
5.4.5继续USSD会话（CONTINUE）操作
CONTINUE操作的目的是继续保持SP与USSDC之间的会话，它可以由SP发出，也可以由移动台发出。
5.4.5.1CONTINUE消息的定义（SPUSSDC）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
CommandID
4
UnsignedInteger
消息标识
FH=
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范
围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范
围为：
0x0h~0x7FFFFFFFh
消息体
Ussd_Version
B
1
UnsignedInteger
USSD会话版本号:
0x10:
PHASEI
0x20:
PHASEII
0x25:
PHASEII+
要求与BEGIN消息中保持一致
Ussd_Op_Type
1
UnsignedInteger
USSD对话操作类型：
0x01（Request）:
USSR（SP->USSDC）
0x02（Notify）:
USSN
（SP->USSDC）
0x03（Response）:
USSDC->SP
MsIsdn
21
C-OctetString
移动台号码，保持与BEGIN消息一致
Service_Code
21
C-OctetString
业务接入码，保持与BEGIN消息一致
Code_Scheme
1
UnsignedInteger
USSD串内容的编码方案：
1、USSDC->SP时该字段填写0x44,表示8位编码；
2、SP->USSDC时该字段指示
USSDC对Ussd_Content进行编码的格式，此时Ussd_Content本身的内容为8位编码。
常用的编码格式包括：
0x0F（7位
编码）、0x11（16位编码）、0x44（8位编码）
Ussd_Content
VarMax182
OctetString
USSD串的内容
上海贝尔阿尔卡特回答：
满足。
5.4.6结束USSD会话（END）操作
END操作的目的是正常释放USSD会话，它只能由SP发出。
5.4.6.1END消息的定义（SPUSSDC）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_StatusH
4
UnsignedInteger
0:
正常结束
1:
用户余额不足
2:
SP认证失败
3:
无业务信息
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范
围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范
围为：
0x0h~0x7FFFFFFFh
消息体
Ussd_Version
B
1
UnsignedInteger
USSD会话版本号:
0x10:
PHASEI
0x20:
PHASEII
0x25:
PHASEII+
要求与BEGIN消息中保持一致
Ussd_Op_Type
1
UnsignedInteger
USSD对话操作类型：
0x03（Response）:
BEGIN消息由移动台发起
0x04（Release）:
BEGIN消息由SP发起
MsIsdn
21
C-OctetString
移动台号码，保持与BEGIN消息一致
Service_Code
21
C-OctetString
业务接入码，保持与BEGIN消息一致
Code_Scheme
1
UnsignedInteger
USSD串内容的编码方案：
1、USSDC->SP时该字段填写0x44,表示8位编码；
2、SP->USSDC时该字段指示
USSDC对Ussd_Content进行编码的格式，此时Ussd_Content本身的内容为8位编码。
常用的编码格式包括：
0x0F（7位
编码）、0x11（16位编码）、
0x44（8位编码）
Ussd_Content
VarMax182
OctetString
USSD串的内容
上海贝尔阿尔卡特回答：
满足。
5.4.7中止USSD会话（ABORT）操作
ABORT操作的目的是异常释放USSD会话，它可以由SP发出，也可以由移动台发出。
5.4.7.1ABORT消息定义（SPUSSDC）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
会话异常释放的原因
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范围
为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范围
为：
0x0h~0x7FFFFFFFh
上海贝尔阿尔卡特回答：
满足。
5.4.8USSD会话转移（SWITCH）操作
SWITCH用于BEGIN由移动台发起的会话，它将USSD会话从一个SP1转移到另一个
SP2。
当SP1发出SWITCH后应释放当前对话的本地资源，USSDC收到SWITCH后将关闭与SP1的对话分支，然后与SWITCH指定的业务SP2建立会话，USSDC与移动台之间的会话仍然保持，后续的USSD会话交互在移动台与SP2之间进行。
5.4.8.1SWITCH消息定义（SPUSSDC）
字段名
大小（字节）
类型
说明
消
息
头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
11一
4
UnsignedInteger
消息标识
H
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范
围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范
围为：
0x0h~0x7FFFFFFFh
消息体
Switch_Mode
B
1
UnsignedInteger
转移模式：
0:
全局转移
1:
本地转移
MsIsdn
21
C-OctetString
移动台号码，保持与BEGIN消
息一致
Org_Service_Code
21
C-OctetString
源业务信息
Dest_Service_Code
21
C-OctetString
转移的目的业务接入码
Ussd_Content
VarMax182
OctetString
USSD串的内容
上海贝尔阿尔卡特回答：
满足。
5.4.9开始转移USSD会话（SWITCH_BEGIN）操作
SWITCH_BEGIN操作的目的是在源SP发送
升级会员 