中国移动USSD应用接口协议.docx
《中国移动USSD应用接口协议.docx》由会员分享，可在线阅读，更多相关《中国移动USSD应用接口协议.docx（25页珍藏版）》请在冰豆网上搜索。
中国移动USSD应用接口协议
QB-╳╳-╳╳╳-╳╳╳╳
中国移动通信企业标准
前言
本规范规定了移动USSD业务开展过程中USSDC与SP之间的消息类型和定义，目前为1.0.0版本。
根据业务的发展，规范中的信令操作和参数将会做进一步的调整和增加。
本标准由中国移动通信集团公司技术部提出并归口。
本标准起草单位：
中国移动通信集团公司研发中心。
本标准主要起草人：
丁晓城
本标准解释单位：
同提出单位。
1范围
本规范规定了以下内容：
1）业务提供商与USSDC之间的接口协议；
本规范适用于各SP和USSDC的开发厂商。
上海贝尔阿尔卡特回答：
明白。
2引用标准
下列标准所包含的条文，通过在本标准中引用而成为本标准的条文。
本标准出版时，所示版本均为有效。
所有标准都会被修订，使用本标准的各方应探讨使用下列标准最新版本的可能性。
上海贝尔阿尔卡特回答：
明白。
3术语和定义
英文缩写
英文全称
说明
USSDC
UnstructuredSupplementServiceDataCenter
USSD中心
4USSDC与USSD业务应用的接口模型
图1USSDC与USSD业务应用的接口模型图
上海贝尔阿尔卡特回答：
满足。
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消息定义（SPàUSSDC）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
未使用，置为0xFFFFFFFF
Receiver_ID
4
UnsignedInteger
未使用，置为0xFFFFFFFF
B消息体
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）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
0：
正确
1：
非法SP_ID
2：
认证错
3：
版本太高
4：
其他错误
Sender_ID
4
UnsignedInteger
未使用，置为0xFFFFFFFF
Receiver_ID
4
UnsignedInteger
未使用，置为0xFFFFFFFF
B消息体
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）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，置为0xFFFFFFFF
B消息体
Ussd_Version
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）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
B消息体
Ussd_Version
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）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
0：
正常结束
1：
用户余额不足
2：
SP认证失败
3：
无业务信息
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
B消息体
Ussd_Version
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）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
B消息体
Switch_Mode
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发送SWITCH消息时，USSDC与目的SP建立一个USSD会话，由USSDC发给目的SP。
5.4.9.1SWITCH_BEGIN消息定义（USSDCSP）
（航标用Begin）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，置为0xFFFFFFFF
B消息体
Ussd_Version
1
UnsignedInteger
USSD会话版本号
0x10：
PHASEI
0x20：
PHASEII
0x25：
PHASEII+
Ussd_Op_Type
1
UnsignedInteger
USSD对话操作类型：
0x01：
表示Request
MsIsdn
21
C-OctetString
移动台号码
Org_Service_Code
21
C-OctetString
源业务信息
Dest_Service_Code
21
C-OctetString
目的业务接入码
Code_Scheme
1
UnsignedInteger
USSD串内容的编码方案：
该字段填写0x44，表示8位编码；
Ussd_Content
VarMax182
OctetString
USSD串的内容
上海贝尔阿尔卡特回答：
满足。
5.4.10计费指示（CHARGE）操作
CHARGE用于SP请求USSDC进行计费，USSDC发送CHARGE_RESP消息返回计费结果。
5.4.10.1CHARGE消息定义（SPUSSDC）
字段名
大小（字节）
类型
说明
H消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
未使用，置为0
Sender_ID
4
UnsignedInteger
消息发出方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
Receiver_ID
4
UnsignedInteger
消息接收方会话控制标识，范围为：
0x0h~0x7FFFFFFFh
B消息体
Charge_Ratio
4
UnsignedInteger
计费费率，单位为分
Charge_Type
4
UnsignedInteger
计费类型：
0x00-免费
0x01-按条
0x02-包月
0x03
0x04
Charge_Resource
21
C-OctetString
计费源标识，由SP企业代码与业务代码组成
Charge_Location
1
UnsignedInteger
计费地点：
0x01-USSD中心与USSD业务网关均产生计费话单，0x02-仅USSD中心产生计费话单，0x03-仅USSD业务网关产生话单
5.4.10.2CHARGE_RESP消息定义（USSDCSP）
字段名
大小（字节）
类型
说明
消息头
Command_Length
4
UnsignedInteger
定义整个消息包的大小
Command_ID
4
UnsignedInteger
消息标识
Command_Status
4
UnsignedInteger
计费结果：
0：
成功
其它：
失败
Sender_ID
4
Unsign
升级会员 