Home
MATRIXX Pricing and Rating
Rating
The following information describes MATRIXX Charging Application rating functionality.
Rating One-Time Events
MATRIXX Charging Application supports 3GPP Immediate Event Charging (IEC) to authorize and charge for one-time events, such as SMS, MMS, or other messaging services (such as purchases of ring tones, media, or mobile Apps) and in-app micro-transactions. Typically the data for event-based requests maps to debit, refund, query, and price checking operation types. If configured, after a successful IEC operation, a notification (MtxEventChargeNotification) is triggered.
Refunding Using a Unit Value
You can request refunds to the main simple balance of prepaid or postpaid accounts by specifying a unit value in the Requested-Service-Unit.

Welcome
MATRIXX Release Notes
MATRIXX Architecture
MATRIXX Installation and Upgrade
MATRIXX Configuration
MATRIXX Security
MATRIXX Integration
MATRIXX Diameter Integration
MATRIXX Call Control Framework Integration
MATRIXX TM Forum Integration
MATRIXX 5G Integration
MATRIXX 5G Event Streaming
MATRIXX Event Streaming
MATRIXX Administration
MATRIXX Web App Administration
MATRIXX Monitoring and Logging
MATRIXX Policy
MATRIXX Kafka CDR Consumer
MATRIXX Pricing and Rating
- About Pricing and Rating
  MATRIXX Pricing and Rating provides an introduction to MATRIXX pricing and rating functionality and describes how to define the catalog components necessary for rating and policy selection. It also provides an overview of the MATRIXX rating process and an introduction to My MATRIXX, a web-based user interface application you use to create and manage product catalogs.
- Rating
  The following information describes MATRIXX Charging Application rating functionality.
  - Rating Overview
    MATRIXX Charging Application can perform both online and offline rating in support of next-generation networks and legacy systems. It can also handle hybrid sets of convergent, prepaid, and postpaid services, enabling service providers to have a diverse subscriber base.
  - Usage and Non-Usage Rates
    Rates can be based on service usage and on activities not related to service usage, such as cycle processing, first use of a balance, catalog item purchases, and product offer cancelations.
  - Event Types
    MATRIXX Engine supports multiple built-in event types that are defined in a tree hierarchy based on pricing configuration and stored in the pricing database. You can define custom subordinate event types (sub events) for an event type.
  - Operation Types
    Use operation types to customize non-usage events. The operation type in an event mapping must match an event type. For example, the recurring_subscriber operation can only correspond to a recurring event, such as SubscriberCustomRecurringEvent.
  - Service Types
    Each network message received for subscriber usage is associated with a service type, and each category of usage within the network message is associated with a service context.
  - Device Types
    The MATRIXX Engine supports mobile and login devices. A mobile device uses one or more associated phone numbers to identify the subscription associated with the device. Login devices use a string value (SIP URI (Session Initiation Protocol Uniform Resource Identifier), an NAI (Network Address Identifier), or a PrivateId) for identification.
  - Normalization
    MATRIXX Engine uses a process called normalization to condense large sets of discrete field values into a manageable set of parameters. Each single normalizer parameter value represents an aggregate value set, so that assigning a result to every possible field value is not required.
  - Rating One-Time Events
    MATRIXX Charging Application supports 3GPP Immediate Event Charging (IEC) to authorize and charge for one-time events, such as SMS, MMS, or other messaging services (such as purchases of ring tones, media, or mobile Apps) and in-app micro-transactions. Typically the data for event-based requests maps to debit, refund, query, and price checking operation types. If configured, after a successful IEC operation, a notification (MtxEventChargeNotification) is triggered.
    - Refunding Failed One-Time Events
      One-time events that are not delivered successfully can use the 3GPP Refund Account principle to remove the balance impacts associated with the charge.
    - Refunding Using a Unit Value
      You can request refunds to the main simple balance of prepaid or postpaid accounts by specifying a unit value in the Requested-Service-Unit.
  - Rating Sessions
    MATRIXX Charging Application supports the 3GPP Session Charging with Unit Reservation (SCUR) and Event Charging with Unit Reservation (ECUR) to handle authorization and accounting for subscriber usage.
  - How Rating Is Performed
    When events are received in MATRIXX Engine, a list of candidate product offers is created and examined for each event segment to determine which ones apply. Determining the candidates involves identifying the valid price components, which is dependent on the validity of the balances and normalization values.
  - Advice of Charge
    MATRIXX Engine supports Advice of Charge (AoC) for usage and non-usage rating.
  - Detecting Duplicate Network Messages
    MATRIXX Engine can detect when a duplicate network message is received and does not repeat the processing for the duplicate message.
  - Using Time Zones for Rating
    You can configure rates based on the time zone of MATRIXX Engine, the time zone of the subscription, or the UTC offset in the network message.
  - Generating Notifications During Rating
    Real-time notifications enable you to alert subscribers and group administrators immediately when product offers are purchased, canceled, or expire, when balances expire, and when balances are nearing credit limits and assets are about to expire, so they are aware of their current spending situations.
  - MATRIXX Event Detail Records
    MATRIXX Engine generates an _glossary/edr.html for all activities that can trigger rating, such as usage, catalog item purchases and cancelations, recurring cycle processing, or the first use of a balance. MATRIXX Engine also generates EDRs for non-rated events such as forfeitures. You configure event generation in My MATRIXX, including the events to generate and whether to add a custom container with additional mapped fields.
  - Processing Call Detail Records
    The MATRIXX Engine can rate call detail records (CDRs) in Solution42 format and save the results to MATRIXX Event Detail Records (EDRs) so the information can be imported into a third-party system for billing or analytical processing.
  - MATRIXX Event Files
    MATRIXX Event Files (MEFs) contain a list of usage and non-usage event types generated during transaction processing. MEFs are meant to be published to, and consumed outside of, MATRIXX, and can be input to third-party applications.
  - Multi-Tenancy Support
    MATRIXX supports multi-tenancy for service providers who want to host more than one tenant on the same sub-domain, where a tenant is a subset of the subscribers within a subscriber base that use the same pricing configuration and that have the same set of business behaviors, such as prepaid or postpaid, or the same Mobile Virtual Network Operator (MVNO).
  - 5G AMF Charging
    MATRIXX supports charging for usage related to the 5G Access and Mobility Management Function (AMF).
  - Other 5G Service Charging
    MATRIXX supports charging for the following services in the 5G Release 17 Specification:
  - Network Exposure Function Charging
    MATRIXX supports charging for the Network Exposure Function (NEF).
  - Cycle Processing
    The Charging Server supports balance cycles, billing cycles, and purchased item cycles.
- Pricing
- Appendices
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Refunding Using a Unit Value

You can request refunds to the main simple balance of prepaid or postpaid accounts by specifying a unit value in the Requested-Service-Unit.

For example:

CC-Request-Type=4 (EVENT_REQUEST)
  Requested-Action=1 (REFUND_ACCOUNT)
  Multiple-Services-Credit-Control
  Requested-Service-Unit
      CC-Money = {Unit-Value=0.75, *Currency-Code=840}

You must specify the Unit-Value. The Currency-Code is optional in the request but if it is specified then it must be the same as the ClassId of the main balance in the subscription's wallet.

If the subscriber's wallet does not have a main balance but the Currency-Code is specified in the request, then the currency code is used to find an alternate balance in the subscriber's wallet to issue a refund.

The Requested-Service-Unit AVP can contain other unit types such as CC-Time or CC-Total-Octets but these are not supported and are ignored.

Important: You cannot request a refund using CC-Money and Refund-Information in the same CCR; the request will fail.

As with refunds using Refund-Information, when the refund is successful, an MtxUsageRefundEvent EDR is generated. The event does not distinguish if the refund was a result of a Refund-Information request or a Requested-Service-Unit request.

For additional information about refunds, see the discussion about refunding failed one-time events.