发布时间 : 星期一 文章中国联通增值业务鉴权中心接口规范-VAC与增值系统接口分册-1212更新完毕开始阅读71727d68ddccda38376baf5c
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
权（当业务系统发起Operation Type=8鉴权，或针对高信用度产品发起Operation Type=0鉴权，vac返回成功），vac返回失败1006；当屏蔽所有业务能力时，servicetype填写00。
（2）当Operation Type=8时，VAC开通该用户的ServiceType对应业务能力。 （3）当Operation Type=3时，
? 当servicetype不为00、SPID不为00000、SP_ProductID为00000时，退订用户SPID下的
servicetype所有订购关系；
? 当servicetype为00、SPID不为00000、SP_ProductID为00000时，退订用户SPID下所有业
务类型所有订购关系；
? 当servicetype不为00、SPID为00000、SP_ProductID为00000时，退订用户servicetype
下的所有订购关系；
? 当servicetype为00、SPID为00000、SP_ProductID为00000时，退订用户所有订购关系； （4）针对点对点彩信，业务代码、产品代码等按照以下方式分配，彩信中心按照以下规则填写后发起到vac的国内点对点彩信业务鉴权，彩信国际互通网关按照以下规则填写后发起到vac的国际彩信业务鉴权：
? CPID：不需要规定，不使用 ? SPID ：99999
? 国际彩信业务代码 ： 32000001，其中32 彩信中心编码，00 全国业务，0001 业务编
号；国际彩信产品代码：3200000101
? 国内点对点彩信代码：32xx0002，其中32 彩信中心编码，xx 分公司业务（xx为省分代
码），0002 业务编号；国内点对点彩信产品代码 32xx000201
? 国内点到mail彩信代码：32xx0003，其中32 彩信中心编码，xx 分公司业务（xx为省分
代码），0003 业务编号；国内点对点彩信产品代码 32xx000301
（5）针对业务代码等信息，增值系统、vac、业务支撑系统必须都是可配、可调的
（6）增值系统发起ServiceID计费鉴权情况下，VAC根据业务找产品，其中有一个代收费产品，即按照代收费处理。
2） CheckPriceResp鉴权批价应答 方向 : VAC -> 业务系统/业务引擎
为了避免VAC较忙时无法在规定时间内内响应而造成部分业务的定购的流失。在业务系统向AAA发鉴权批价请求后，业务系统作为Server，VAC作为Client，业务系统等待AAA的响应。
CheckPriceResp鉴权批价应答消息中包含的参数如下:
字段名称 Result_Code ConfirmInterval 类型 Integer4 Integer4 长度/最大描述 长度（字节） 4 4 结果码。0 : OK, 其它为错误代码，见附录 等待CheckPriceConfirm 消息的时间间隔。如果操作失败或者该域是不相关的缺省值设为“－1” 确认标识。如果需要确认，需要接着发一条confirm消息，并保持其SequenceNumber和本消息的一致 0：无需确认 11
NeedConfirm Interger1 1 中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
1：需要确认 -1：如果操作失败缺省值设为“-1” originalADR Octet String 原始地址，主要用于伪码转换时返回原来的用户号码。 MT：返回接收方用户原号码 MO：返回发送方用户伪码。 伪码转换策略可配置。 20 事务关联ID，点播业务的事务关联，由AAA产生。格式如下：8位随机序列数； 为空(二进制0)表示无效 计费类型，该字段不能为空。 0：不计费，仅用于核减SP对称的信道费 1：免费 2：按条/次计费 3：按包月收取 4：封顶计费 5：按流量计费 6：按时长计费 7：包多月计费 8：包月计费+单位费率（该值不另外增加话单中计费类型字段取值，对包月计费+单位费率资费类产品中的包月计费话单类型填3，对单位计费话单类型填2） 对会话类计费，5或6必须返回 用于告知业务接入网关如何处理用户请求，有以下几种类型： 1. 需定购 2. 需确认 3. 错误页面（参考错误值） 4. 试用到期 5. 资费修改提示 返回相应错误描述信息给业务系统。 VAC决定是否需要将原消息转至下一网络节点： 0：不需要 1：需要 填写SP_ProductID CRM构成产品标识
36 可选参数 LinkID TLV FeeType TLV 2 Redirect Tlv 4 ReturnMessage NeedToNextNode Tlv TLV 256 1 SP_ProductID Tlv SPEC_ProductTlv 12 12 12
中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
ID ProductID Tlv 8 CRM产品ID 注：当业务系统（目前只针对WAP系统，可配置）发起定购关系鉴权（Operation Type=6）时，如果VAC中已经有该用户对于指定业务的定购关系，响应中向业务系统返回成功，同时返回FeeType 、SP_ProductID、SPEC_ProductID、ProductID字段；当用户无定购关系时，返回1201错误，不返回FeeType 、SP_ProductID、SPEC_ProductID、ProductID字段。
注：当CheckPrice请求中Operation Type=1（定购）时，ReturnMessage 具体格式为： existsub:spid,sp_productid,spec_productid,productid; 其中existsub结构体表示该请求对应的已定购产品的信息。当用户要定购产品和前一已定购产品有互斥关系时，existsub填写已定购并生效的互斥产品信息；
例如用户已定购1元手机邮箱（spid,sp_productid,spec_productid,productid分别为99999,8200000101,123451234501,12345001），再定购2元手机邮箱（99999,8200000102,123451234502,12345002）时，vac返回1204错误，并在ReturnMessage中返回“existsub:99999,8200000101,123451234501,12345001”，表示该已定购产品和要定购产品互斥。 4.1.4.5 鉴权批价确认
鉴权批价确认消息用于业务使用结果的确认，若业务使用失败，需要进行费用回补。
1） CheckPiriceConfirm鉴权批价确认请求 方向 : 业务系统/业务引擎 -> VAC
CheckPiriceConfirm鉴权批价确认请求中包含的参数如下: 字段名称 SourceDevice_Type 类型 Integer4 长度/最大描述 长度（字节） 4 原始端设备类型，参考附录B SourceDevice_ID Octet String 20 原始端设备标识，定义为“2位设备类型＋3位省分代码＋1位序列号” 2位设备类型见vac与增值系统规范附录B， 3位省分代码见VAC与BSS规范附录A.16 目标端设备类型 目标端设备标识，定义为“2位设备类型＋3位省分代码＋1位序列号” 2位设备类型见vac与增值系统规范附录B， 3位省分代码见VAC与BSS规范附录A.16 和对应ChickPrice请求中的SequenceNumber相同。标识多个13
DestinationDevice_Type DestinationDevice_ID Integer4 4 Octet String 20 SequenceNumber Octet String 20 中国联通增值业务鉴权中心接口规范 VAC与增值业务系统接口分册（V1.1）
请求是属于同一个事务。 SequenceNumber是消息生成时间、业务系统标识和序列号的组合，其格式为： MMDDHHMMSSYYYYYYXXXX，其中 MMDDHHMMSS：当前时间 YYYYYY：业务系统标识 XXXX：序列号 ErrCode End_Time Integer4 4 ：错误代码 0：成功 非0：失败，错误码见附录 业务结束时间： YYYYMMDDHHMMSS 年月日时分秒 业务类型，见VAC与BSS接口规范附录A 7 Octet String 14 ServiceType
Octet String 2 2） CheckPiriceConfirmResp鉴权批价确认应答 方向 : VAC -> 业务系统/业务引擎
CheckPiriceConfirmResp鉴权批价确认应答消息中包含的参数如下:
字段名称 Result_Code 类型 Integer4 长度/最大描述 长度（字节） 4 结果码。0 : OK, 其它为错误代码，见附录 4.1.4.6 流量计费消息
流量计费消息用于基于WAP的业务流量计费和时长计费，如：流媒体业务、下载类业务等。将来可以扩展用于话音类增值业务。
1） TrafficPrice流量计费请求 方向 : 业务系统/业务引擎--> VAC
TrafficPrice流量计费请求消息中包含的参数如下:
字段名称 SourceDevice_Type SourceDevice_ID 类型 Integer4 长度/最大描述 长度（字节） 4 原始端设备类型参考附录B 原始端设备标识，定义为“2位设备类型＋3位省分代码＋1位序列号” 2位设备类型见vac与增值系统规范附录B， 3位省分代码见VAC与BSS规范附录A.16 目标端设备类型 14
Octet String 20 DestinationDevice_Type Integer4 4