charging和billing的余额操作DCC接口

1、精选优质文档-倾情为你奉上Billing与Charging的余额操作DCC接口1. Billing与Charging的DCC在Diameter基础协议上扩展的应用协议Diameter Credit Control Application参数定义1.1. DiameterIETF的AAA工作组同意将Diameter协议作为下一代的AAA协议标准。Diameter(为直径，意为着Diameter协议是RADIUS协议的升级版本)协议包括基本协议，NAS(网络接入服务)协议，EAP(可扩展鉴别)协议，MIP(移动IP)协议，CMS(密码消息语法)协议等。Diameter协议支持移动IP、NAS请求和

2、移动代理的认证、授权和计费工作，协议的实现和RADIUS类似，也是采用AVP，属性值对(采用Attribute-Length-Value三元组形式)来实现，但是其中详细规定了错误处理, failover机制,采用TCP协议，支持分布式计费，克服了RADIUS的许多缺点，是最适合未来移动通信系统的AAA协议。接口概述传统的用于完成计费功能的Radius以前的方式采用远程访问拨号用户服务RADIUS(Remote Access Dial up User Service)；Raduis英文原意为半径，原先的目的是为拨号用户进行鉴别和计费。后来经过多次改进，形成了一项通用的鉴别计费协议-RADIUS

3、(远端鉴权拨入用户服务- Remote Authentication Dial In User Service)协议，以其简单安全，易于管理，扩展性好，而得到广泛应用。但是由于协议本身的缺陷，比如基于UDP的传输、简单的丢包机制、没有关于重传的规定和集中式计费服务，都使得它不太适应当前网络的发展，需要进一步改进。随着新的接入技术的引入和移动网络的快速扩容，对AAA啥意思，AAA协议指的是Authentication（鉴别），Authorization（授权），Accounting（计费）。协议提出了新的要求，使得传统的RADIUS结构的缺点日益明显。目前3G网络正逐步向全IP网络演进，不仅在核

4、心网络使用支持IP的网络实体，在接入网络也使用基于IP的技术，而且移动终端也成为可激活的IP客户端。这就需要采用新一代的AAA协议Diameter。Diameter基础协议为各种认证、授权和计费业务提供了安全、可靠、易于扩展的框架。以此为基础定义Diameter应用，只需要定义应用协议的应用标识、参与通信的网络功能实体、相互通信的功能实体间的消息内容以及协议过程，就可以完全依赖Diameter基础协议完成特定的接入和应用业务。Diameter协议具有如下特性： (1)拥有良好的失败机制，支持失败替代(failover)和失败回溯(faiback)；(2)拥有快速检测到对端不可达的能力； (3)

5、拥有更好的包丢弃处理机制，Diameter协议要求对每个消息进行确认；(4)可以保证数据体的完整性和机密性； (5)支持端到端安全，支持TLS和IPSec； (6)为每个会话进行认证/授权，以保证安全性； 在Diameter基础协议上扩展的应用协议Diameter Credit Control Application，定义了针对预付费用户的计费机制，采用信用额度控制实现了基于会话及事件的计费，解决了对于预付费的计费需求。1.2. DCC消息结构定义DiameterCC协议的消息结构如下，这些字段是以网络字节顺序传送的。0123012345670123456701234567012345671V

6、ersionMessage Length2command flagsCommand-Code3Application-ID4Hop-by-Hop Identifier5End-to-End Identifier6AVPAVP（Attribute Value Pair）s.NAVPs其中，AVP结构为：0123012345670123456701234567012345671AVP Code2VMPrRrrrAVP Length3Vendor-ID (opt)4Data.NData说明：在消息体定义中，类型域中的OctetStringN（N为整数），由基本类型OctetString派生出来，限制

7、长度不大于N；必选属性域“M”表示该AVP在消息中必选，“C”表示该AVP在消息中条件可选。AVP名称前面的*表示该AVP是可重复的。对于AVP的M位属性和Vendor-ID定义参见接口总册。1.3. CCR和CCA消息定义1.3.1. Credit-Control-Request消息定义 <CCR> := < Diameter Header: 272, REQ, PXY > < Session-Id > Origin-Host Origin-Realm Destination-Realm Auth-Application-Id Service-Contex

8、t-Id CC-Request-Type CC-Request-Number Destination-Host User-Name Origin-State-Id Event-Timestamp * Subscription-Id Termination-Cause Requested-Action Multiple-Services-Indicator * Multiple-Services-Credit-Control Service-Information * AVP AVP名称AVP代码数据类型必选属性描述Session-Id263UTF8StringMDiameter会话ID。格式：

9、<DiameterIdentity><high 32 bits><low 32 bits><optional value><DiameterIdentity>同Origin-Host。<high 32 bits>表示系统当前时间的10进制字符串。<low 32 bits>表示循环递增，初始值为0，系统重新启动时设置为0。<optional value>保留。以上各字段以“;”字符相隔。例如：C;523 Origin-Host264DiameterIdentityM发出Diameter消息的主机Ori

10、gin-Realm296DiameterIdentityM发出Diameter消息的主机所在的域Destination-Host293DiameterIdentityC目的主机Destination-Realm283DiameterIdentityM目的主机所在的域Auth-Application-Id258Unsigned32M用于重认证/授权的应用唯一标识。DCCA 4Service-Context-Id461UTF8StringM一个DCC业务的唯一标识（可扩展）。余额管理：ABMCC-Request-Type416EnumeratedM请求类型。1：INITIAL_REQUEST2：U

11、PDATE_REQUEST3：TERMINATION_REQUEST4：EVENT_REQUESTCC-Request-Number415Unsigned32M请求流水号，用于唯一标识Diameter会话的一个请求。User-Name1UTF8StringCNAI格式的用户名称。Origin-State-Id278Unsigned32COrigin-Host的状态ID。Event-Timestamp55TimeC事件发生的时间。*Subscription-Id443GroupedM用于标识业务签约方终端用户的信息。呼叫流程时填写计费方信息该AVP组包含：Subscription-id-type

12、Subscription-id-dataSubscription-Id-Type450EnumeratedMEND_USER_E164：0END_USER_IMSI：1END_USER_SIP_URI：2END_USER_NAI：3END_USER_PRIVATE：4 Subscription-Id-Data444UTF8StringM终端用户标志。Termination-Cause295EnumeratedC说明：用于指示Diameter客户端会话终止的原因。定义了如下的值：DIAMETER_LOGOUT 1用户发起的中断。DIAMETER_SERVICE_NOT_PROVIDED 2当用户

13、在接收到授权应答消息之前断开时使用本值。DIAMETER_BAD_ANSWER 3表示Diameter客户端收到的授权应答未被成功处理。DIAMETER_ADMINISTRATIVE 4因为管理原因，如接收到Abort-Session-Request消息等，用户没有获得接入授权或连接被断开。DIAMETER_LINK_BROKEN 5与用户的通信突然断开。DIAMETER_AUTH_EXPIRED 6因为授权的会话时间到期，用户的接入终止。DIAMETER_USER_MOVED 7用户正在接受其它Diameter客户端的服务。DIAMETER_SESSION_TIMEOUT 8用户的会话超时，

14、服务已经终止Requested-Action436EmumeratedC如果CCR命令中CC-Request-Type的值设置为EVENT_REQUEST，则Requested_Action AVP中包含了所要请求的行为。DIRECT_DEBITING 0REFUND_ACCOUNT 1CHECK_BALANCE 2PRICE_ENQUIRY 3 REQUEST_BALANCE 4 （余额申请）AGGREGATE_ENQUIRY 5 (累计量查询)Multiple-Services-Credit-Control456GroupedC包含多业务独立信用控制相关的AVP。目前每个实例携带一个业务。

15、Requested-Service-Unit437GroupedC请求使用单元 CC-Time420Unsigned32C请求使用的时间。单位：秒。 CC-Money413GroupedC说明：该值给出了指定货币的金额总数。 Unit-Value445GroupedM说明：十进制的数值。由Value-Digits，Exponent组合表示具体的一个指数形式的数。 Value-Digits447Integer64M说明：包含数值的有效数字（不包括原数值中的小数点）。如果由于小数点不存在而导致与原数值大小不同，则必须在Exponent中填入十的指数。例如，表示0.05这个数， Value-Digi

16、ts AVP 必须设置成5，而Exponent AVP值必须设置成-2。 Exponent429Integer32C说明：Unit-Value中的指数部分。如果Exponent缺失，必须认为指数为0。 Currency-Code425Unsigned32C说明：货币代码。指明了金钱单位所使用了哪种货币。在 ISO 4217 standard ISO4217，定义了具体的值。 CC-Total-Octets421Unsigned64C已使用的上下行总字节数。 CC-Input-Octets412Unsigned64C从终端用户收到的已使用字节数。 CC-Output-Octets414Unsig

17、ned64C发送到终端用户的已使用字节数。 CC-Service-Specific-Units417Unsigned64C已使用的特定业务单元数，出现在某些业务的授权单元不是以时间或流量为计量单位的情况。 *Used-Service-Unit446GroupedC从上一次测算结束点开始所测算出的已使用单元总数。 Reporting-Reason872EnumeratedC3GPP扩展，指明为单个或多个类型的配额上报使用情况的原因。 Tariff-Change-Usage452EmumeratedC定义了在一个报告周期中发生费率切换时，所使用的单元是在费率切换前、后，或者跨越不同的费率。如果该A

18、VP被忽略，表明没用费率切换发生。 CC-Time420Unsigned32C已使用的时间。单位：秒。 CC-Total-Octets421Unsigned64C已使用的上下行总字节数。 CC-Input-Octets412Unsigned64C从终端用户收到的已使用字节数。 CC-Output-Octets414Unsigned64C发送到终端用户的已使用字节数。 CC-Service-Specific-Units417Unsigned64C已使用的特定业务单元数。 Service-Identifier439Unsigned32C业务识别标识。 Reporting-Reason872Enum

19、eratedC3GPP扩展，指明为单个或多个类型的配额上报使用情况的原因。 Trigger1264GroupedC触发器。如果存在该参数但是不包含任何Trigger-Type，则禁止任何触发器。 *Trigger-Type870EnumeratedC用于指示单个重授权事件类型。Service-Information873GroupedC业务信息组 ABM-InformationGroupedC余额管理信息组ABM-Information：AVP名称AVP代码数据类型必选属性描述*Request-Current-BalanceGroupedC当前帐户余额信息 Account-IdUTF8Stri

20、ngM帐户ID Account-Book-TypeUTF8StringM帐本类型 BalanceInteger64M帐本余额数值（单位为分）Effect-DateTimeM帐本生效时间Expire-DateTimeM帐本实效时间*Report-Aggregate-InfoGroupedC累计量信息 Aggregate-Type-IdUTF8StringM累计量类型标识 Aggregate-Cycle-IdUTF8StringM累计周期标识 Aggregate-AmountInteger64M累计量数值1.3.2. Credit-Control-Answer消息定义 <CCA> :=

21、 < Diameter Header: 272, PXY > < Session-Id > Result-Code Origin-Host Origin-Realm Auth-Application-Id CC-Request-Type CC-Request-Number CC-Session-Failover * Multiple-Services-Credit-Control Cost-Information Credit-Control-Failure-Handling Direct-Debiting-Failure-Handling * Redirect-Hos

22、t Redirect-Host-Usage Redirect-Max-Cache-Time * Failed-AVP Service-Information * AVP AVP名称AVP代码数据类型必选属性描述Session-Id263UTF8StringMDiameter会话ID。Result-Code268Unsigned32MResult-Code数据域包括一个由INAN管理的32位地址空间表示错误。1xxx: Informational2xxx: Success3xxx: Protocol Errors4xxx: Transient Failures5xxx: Permanent Fa

23、ilureOrigin-Host264DiameterIdentityM发出Diameter消息的主机。Origin-Realm296DiameterIdentityM发出Diameter消息的主机所在的域。Auth-Application-Id258Unsigned32M用于重认证/授权的应用唯一标识。 DCCA 4CC-Request-Type416EnumeratedM请求类型。1：INITIAL_REQUEST2：UPDATE_REQUEST3：TERMINATION_REQUEST4：EVENT_REQUEST CC-Request-Number415Unsigned32M请求流水号

24、，用于唯一标识Diameter会话的一个请求。CC-Session-Failover418EnumeratedC标明是否支持在一个CC会话进行过程中将CC消息流转向备用服务器。*Multiple-Services-Credit-Control456GroupedC包含多业务独立信用控制相关的AVP。 Granted-Service-Unit431GroupedC包含允许DCC客户端给终端用户提供服务的单元总数，当这些单元被用完后，DCC客户端必须向DCC服务器申请新的配额，或者停止向终端用户提供服务。 Tariff-Time-Change451TimeC费率切换机制对于客户端和服务器是可选的，

25、且不在基于连续时间的业务中使用。 CC-Time420Unsigned32C分配的时间。单位：秒。 CC-Total-Octets421Unsigned64C分配的上下行总字节数。 CC-Input-Octets412Unsigned64C分配的上行字节数。 CC-Output-Octets414Unsigned64C分配的下行字节数。 CC-Service-Specific-Units417Unsigned64C分配使用的特定业务单元数。 *Service-Identifier439Unsigned32C业务识别标识，通过Service-Context-ID和Service-Identifi

26、er的组合可以唯一标识该请求相关的业务。 Validity-Time448Unsigned32C该AVP由DCC服务器发送给DCC客户端，包含所分配的业务单元的有效时间，以秒计。 Result-Code268Unsigned32C该AVP显示一个特定的请求是成功完成或者是出现错误。 Final-Unit-Indication430GroupedC指示在CCA消息（或者AA应答）中Granted-Service-Unit包含业务的最后单元数。当这些单元用完后，DCC客户端负责执行在Final-Unit-Action中指定的行为。 Final-Unit-Action449EnumeratedC指示

27、DCC客户端当用户帐户余额无法支付业务费用时将采取的行动。 Redirect-Server434GroupedC包含重定向服务器。 Redirect-Address-Type433EmumeratedM定义了Redirect-Server-Address中提供的地址类型。 Redirect-Server-Address435UTF8StringM定义了重定向服务器。 Time-Quota-Threshold868Unsigned32C包含以秒计的门限。如果收到Time-Quota-Threshold，DCC客户端在剩余配额低于Time-Quota-Threshold定义的门限值时将向服务器端发

28、起CCR重新授权申请新的配额。在重新授权过程中，DCC客户端将允许用户继续使用业务，直到先前的配额全部用完。 Volume-Quota-Threshold 869Unsigned32C包含以字节计的门限值。 Unit-Quota-Threshold1226Unsigned32C包含以特定业务单元计的门限值。 Quota-Holding-Time871Unsigned32C配额占用时间，单位为秒。 Quota-Consumption-Time881Unsigned32C配额空耗时间，单位为秒。 Trigger1264GroupedC触发器。如果存在该参数但是不包含任何Trigger-Type，则

29、禁止任何触发器。 *Trigger-Type870EnumeratedC用于指示单个重授权事件类型。 PS-Furnish-Charging-Information865GroupedC将OCS返回的特殊数据插入到CDR中 3GPP-Charging-Id2OctetStringM计费标识符 PS-Free-Format-Data866OctectStringMOCS返回的特殊数据 PS-Append-Free-Format-Data867EnumeratedC数据处理方式：0 加在后面1 覆盖Cost-Information423GroupedC业务相关的费用信息 Unit-Value445

30、GroupedM由Value-Digits，Exponent组合表示具体的一个指数形式的数 Value-Digits447Integer64M不含小数点的有效数值 Exponent429Integer32CUnit-Value的指数部分 Currency-Code425Unsigned32M货币代码（在ISO4217中定义） Cost-Unit424UTF8StringC计算的单元,可以是分钟、小时、天、千字节、兆字节等等。Credit-Control-Failure-Handling427EnumeratedC从客户端发送给服务器的CC消息因为网络问题而暂时失败时，CC客户端使用该AVP中的

31、信息决定下一步如何做。Direct-Debiting-Failure-Handling428EnumeratedC当从CC客户端发送到CC服务器的CC消息（Requested-Action AVP 设置为Dierect Debiting）由于网络故障而临时失败时，CC客户端使用该AVP中的信息来决定下一步的行为。Service-Information873GroupedC业务信息组 ABM-InformationGroupedC余额管理业务信息组ABM-Information:AVP名称AVP代码数据类型必选属性描述*Granted-Account-BalanceGroupedC授权的帐户余额

32、信息 Account-IdUTF8StringM帐户ID Acct-Book-TypeUTF8StringM帐本类型 CC-Money413GroupedC返回的授权量说明：该值给出了指定货币的金额总数。 Unit-Value445GroupedM说明：十进制的数值。由Value-Digits，Exponent组合表示具体的一个指数形式的数。 Value-Digits447Integer64M说明：包含数值的有效数字（不包括原数值中的小数点）。如果由于小数点不存在而导致与原数值大小不同，则必须在Exponent中填入十的指数。例如，表示0.05这个数， Value-Digits AVP 必须设

33、置成5，而Exponent AVP值必须设置成-2。 Exponent429Integer32C说明：Unit-Value中的指数部分。如果Exponent缺失，必须认为指数为0。 Currency-Code425Unsigned32C说明：货币代码。指明了金钱单位所使用了哪种货币。在 ISO 4217 standard ISO4217，定义了具体的值。Eff-DateTimeM帐本生效时间Exp-DateTimeM帐本实效时间*Report-Aggregate-InfoGroupedC累计量信息 Aggregate-Type-IdUTF8StringM累计量类型标识 Aggregate-Cy

34、cle-IdUTF8StringM累计周期标识 Aggregate-AmountInteger64M累计量数值1.4. DWR和DWA消息定义略1.5. ASR和ASA消息定义略1.6. CER和CEA略1.7. Result-Code定义参考中国联通IT系统 BSS系统域 在线计费(OCS)接口规范-接口总册2. Billing与Charging的接口定义2.1. 省分Charging向总部Billing申请余额2.1.1. 业务描述在业务使用、周期性费用扣取等处理中，当省分Charging发现本地余额不足时，Charging向总部Billing发送余额申请请求。2.1.2. 接口定义接口名

35、称 余额申请C2B接口协议DCC发起方省分Charging接受方总部Billing2.1.3. 请求参数(仅列出主要参数)AVP名称描述Session-IdDiameter会话ID。例如：C;523 CC-Request-Type请求类型。4：EVENT_REQUEST*Subscription-Id用于标识业务签约方终端用户的信息。呼叫流程时填写计费方信息该AVP组包含：Subscription-id-typeSubscription-id-dataSubscription-Id-TypeEND_USER_E164：0Subscription-Id-Data手机号码（如：78）Request

36、ed-ActionREQUEST_BALANCE 4 （余额申请）Service-Information业务信息组 ABM-Information余额管理信息组*Request-Current-Balance当前帐户余额信息 Account-Id帐户ID Account-Book-Type帐本类型 Balance帐本余额数值（单位为分）Effect-Date帐本生效时间Expire-Date帐本实效时间*Report-Aggregate-Info累计量信息 Aggregate-Type-Id累计量类型标识 Aggregate-Cycle-Id累计周期标识 Aggregate-Amount累计量

37、数值2.1.4. 响应参数(仅列出主要参数)AVP名称描述Session-IdDiameter会话ID。Result-CodeResult-Code数据域包括一个由INAN管理的32位地址空间表示错误。CC-Request-Type请求类型。4：EVENT_REQUEST Service-Information业务信息组 ABM-Information余额管理业务信息组*Granted-Account-Balance授权的帐户余额信息 Account-Id帐户ID Acct-Book-Type帐本类型 CC-Money返回的授权量说明：该值给出了指定货币的金额总数。 Unit-Value说明：

38、十进制的数值。由Value-Digits，Exponent组合表示具体的一个指数形式的数。 Value-Digits Exponent Currency-CodeEff-Date帐本生效时间Exp-Date帐本实效时间2.2. 总部Billing向省分Charging申请余额2.2.1. 业务描述在实现跨多个Charging系统共享余额业务中（例如：A省和B省两个用户共享余额），当A省用户余额不足时，A省Charging向总部Billing申请余额。而总部Billing无余额可用，则向B省用户申请余额后，再授权给A省用户使用。2.2.2. 接口定义接口名称 余额申请B2C接口协议DCC发起方总

39、部Billing接受方省分Charging2.2.3. 请求参数(仅列出主要参数)AVP名称描述Session-IdDiameter会话ID。例如：C;523 CC-Request-Type请求类型。4：EVENT_REQUEST*Subscription-Id用于标识业务签约方终端用户的信息。呼叫流程时填写计费方信息该AVP组包含：Subscription-id-typeSubscription-id-dataSubscription-Id-TypeEND_USER_E164：0Subscription-Id-Data手机号码（如：78）Requested-ActionREQUEST_BALANCE 4 （余额申请）2.2.4. 响应参数(仅列出主要参数)AVP名称描述Session-IdDiam