Home
My MATRIXX Help
Charging Configuration
Charging Configuration has the interfaces you use to create and manage balance, pricing, product offer and bundle, general, and application-related components.
General Configuration
General Configuration has interfaces you use to create pricing plan components. Pricing plan components managed through this interface include announcements, product and system attributes and definitions, currency codes for rate tables, denial codes, field definitions for use in normalizers and rate tables, Diameter Final-Unit-Indication (FUI) profiles and generators, General Ledger (GL) transaction types and info generators, grace period profiles, languages, notification profiles, parameter definitions, pre/post-rating profiles and generators, SH Repository data, Subscriber Information Query components, tax classes for offer categorization, usage quota profiles and components, purge profiles, virtual fields, and usage triggers.
PreRating
MATRIXX Engine uses pre-rating query data for determining when to perform a call out request for subscriber information to an external server or database. You configure pre-rating query data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
Prerating Callout Actions
Prerating call out actions define how to handle queries to an external database or system to retrieve subscriber information.

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
MATRIXX Pay Now
MATRIXX Subscriber Management
MATRIXX Subscriber Management API
MATRIXX Business API SDK
My MATRIXX Help
- About My MATRIXX Help
  My MATRIXX Help provides information about My MATRIXX, a web application that offers a central location for creating pricing plans and configuring MATRIXX charging and rating behaviors. My MATRIXX is intended for pricing administrators who are responsible for creating and maintaining pricing plans and for IT administrators or developers who configure the rating and charging behavior of the online charging system.
- Introducing My MATRIXX
  The following information describes the My MATRIXX interface.
- Using My MATRIXX
  You use My MATRIXX to validate and compile the pricing configuration file, compile pricing, and set up and manage user roles and domains; create and manage catalog items and catalogs, manage eligibility features and rules, and manage the Normalizers interface; create and manage balances, pricing, offers and bundles, general components, and application-related components; and policies for charging and rating. Use General Configuration to create components that support pricing items and charging functionality such as announcements pricing components, attribute definitions, denial codes, products, decision tables, Final Unit Indication (FUI) profiles and generators, general ledger transaction types, notification profiles, normalizer templates, and subscriber information query actions, profiles, and generators.
- Home Menu
  The following information describes the tasks that can be performed using the My MATRIXX Home menu.
- Catalog Configuration
  Catalog Configuration contains the Catalog Items interface that you use to create, change, or delete catalog items; the Eligibility interface to manage eligibility features and rules to determine whether a subscriber, group, or device is eligible for a catalog item; and the Normalizers interface you use to edit normalizers.
- Charging Configuration
  Charging Configuration has the interfaces you use to create and manage balance, pricing, product offer and bundle, general, and application-related components.
  - Balance Configuration
    Balance Configuration contains interfaces you use to create and manage price components including aggregation selectors, balances and balance classes, balance state update profiles and components, meters, and rollover profiles and components.
  - Pricing Configuration
    Pricing Configuration contains interfaces you use to create pricing plan components. Pricing plan components managed through this interface include decision tables, finance and service contracts, filters, price components including charges, discounts, grants, refunds, and forfeitures, and rate tags.
  - Offer and Bundle Configuration
    Offer and Bundle Configuration contains interfaces you use to create and manage pricing and rating components including bundles, offer priority generators, product offers, and product service types and attributes.
  - Normalizer Configuration
    Normalizer Configuration contains interfaces you use to create and manage normalizers, normalizer templates, and normalizer value lists.
  - Tax Configuration
    Tax Configuration contains interfaces you use to create and manage tax classes and selectors, and US taxation. You must have the Manage Tax domain user role to enable this menu.
  - General Configuration
    General Configuration has interfaces you use to create pricing plan components. Pricing plan components managed through this interface include announcements, product and system attributes and definitions, currency codes for rate tables, denial codes, field definitions for use in normalizers and rate tables, Diameter Final-Unit-Indication (FUI) profiles and generators, General Ledger (GL) transaction types and info generators, grace period profiles, languages, notification profiles, parameter definitions, pre/post-rating profiles and generators, SH Repository data, Subscriber Information Query components, tax classes for offer categorization, usage quota profiles and components, purge profiles, virtual fields, and usage triggers.
    - Announcements
      MATRIXX Engine uses announcement data for determining the list of announcements to play to a subscriber during a voice call, and the language they must be played in. Configure announcement data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
    - Attributes
      System attributes and product attributes are properties you can add to certain pricing objects that can be used to influence rating operations and provide information to downstream systems, such as General Ledger accounting systems.
    - Data Modify
      You use the data modify interface to configure data modify actions, data modify profiles, and data modify profile selectors.
    - Denial Codes
      Denial codes are a way to deny service access to subscribers for a specific reason. You define them in My MATRIXX and add them to rate table rows in place of a rating formula, so the value is returned to the network based on the row selected during rating.
    - Final Unit Indication
      You can configure Diameter Final Unit Indication (FUI) information to be static or dynamic.
    - General Ledger Info
      You can configure MATRIXX Charging Application to generate General Ledger (GL) information for inclusion in an _glossary/edr.html.
    - Grace Period Profiles
      You use grace period profiles to configure the length of purchased item cycle grace period(s) that extends the period of time before a cycle goes into a recovery state.
    - Languages
      A language definition indicates that My MATRIXX supports that language.
    - Notifications
      In Notifications you create notification profiles and notification profile selectors that determine when and to which tenants notifications are sent.
    - Object State Update Profiles
      An object state update profile specifies how to extend, limit, or adjust the date/time value of the custom MATRIXX Data Container (MDC) field of an offer owner (subscriber/group/device). Enable an object state update profile by selecting it when configuring an offer owner state update component. The decision table used in an offer owner state update component selects an object state update profile to use to update a custom field of an offer owner. An object state update profile can only be used in combination with an offer owner state update component. For more information, see the discussion about offer owner state update components.
    - Parameters
      You can configure definitions for parameters that you can use in pricing items such as catalog items, bundles, product offers, and price components.
    - PostRating
      MATRIXX Engine uses post-rating profiles and generators for determining a set of actions to apply to a message after it has been processed by rating. You configure post-rating to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
    - PreRating
      MATRIXX Engine uses pre-rating query data for determining when to perform a call out request for subscriber information to an external server or database. You configure pre-rating query data to be dynamic, so a different result occurs based on conditions that are valid at the time of rating.
      - Prerating Callout Actions
        Prerating call out actions define how to handle queries to an external database or system to retrieve subscriber information.
        Create a MAP Callout Action
        Create a Mobile Application Part (MAP) callout action to define callout request parameters for querying subscriber information, such as the subscriber's location or routing number, on an external database, such as a Mobile Number Portability (MNP) database.
        Create an LDAP Callout Action
        Create an LDAP callout action to define callout request parameters for querying subscriber information held on an LDAP server.
        Change a PreRating Callout Action
        You can change a Mobile Application Part (MAP) or LDAP callout action.
        Delete a PreRating Callout Action
        Deleting a PreRating callout action removes it from the pricing plan. When the new pricing XML configuration file is loaded into the database, the PreRating callout action is removed.
        PreRating Callout Action Properties
        You define PreRating call out actions on the PreRating Call Out Actions tab.
      - PreRating Profiles
        A PreRating profile is a collection of PreRating callout actions and data modify actions. A PreRating action can belong to more than one PreRating profile.
      - PreRating Generators
        A PreRating generator selects a profile or a SKIP value for one or more normalizer parameter values that are valid during rating. The PreRating generator specified in the default context of a service type object is invoked for both Diameter Ro messages and 5G charging data request messages.
    - Purge Profiles
      Purge profiles allow you to define retention periods for expired product offers per _glossary/catalog_item.html, _glossary/meter.html, or _glossary/balance.html.
    - SH Repository Data
      Sh repository data profiles allow you to send information between the Policy and Charging Rules Function (PCRF) and the Subscriber Profile Repository (SPR), where MATRIXX Engine is the SPR. The PCRF and SPR communicate by sending Subscription Notification Requests (SNR) and Subscription Notification Answers (SNA) back and forth over Sp. The Sh repository data returns to the PCRF in an SNA.
    - Usage Quota
      Usage quota components are pricing items that are used for selecting usage quota profiles based on conditions that are valid during rating. The usage quota profile defines authorization and quota management settings to be applied to online charging sessions (to authorize a request for quota for a given service and context type). The usage quota component defines the criteria for choosing a usage quota profile as a set of normalized values.
    - Usage Triggers
      Usage triggers activate network changes based on product offers and subscriber profile data. You apply usage triggers to product offers, which then apply to ongoing subscriber sessions.
    - Virtual Fields
      Use virtual fields to avoid creating multiple pricing configurations if your MATRIXX environment accepts multiple rating message types, for example, messages from Diameter and 5G networks.
  - Application Configuration
    Application Configuration components are used by My MATRIXX for creating pricing plan items and are used by MATRIXX Charging Application and MATRIXX Policy Application for charging and rating.
- Policy Configuration
  Policy configuration components are used by MATRIXX Charging Application and MATRIXX Policy Application for charging and rating.
MATRIXX Backoffice Customer Tool Help
MATRIXX Third-Party Licenses
Glossary

Prerating Callout Actions

Prerating call out actions define how to handle queries to an external database or system to retrieve subscriber information.

You can configure the following types of callout actions and add them to Prerating profiles:

Mobile Application Protocol (MAP) callouts to an external database, such as an MNP (mobile number portability) database. You select the type of information you want to query in the Info Query Flags field. You can query any of the following information:
- Subscriber Location
- Subscriber State
- Subscriber IMEI
- Service Info
- Redirection Info
- Routing Info
- MNP Info
- Interrogate Supplementary Service
- Custom
Lightweight Directory Access Protocol (LDAP) callouts to an LDAP server.

When you select one or more Info Query Flags, such as the subscriber location or subscriber state, the request is marked as successful only if that specific information is returned in the response.

MAP Interrogate SS Callouts

Select the Interrogate Supplementary Service flag to configure a MAP-Interrogate-SS callout, for example, to recover the call forwarding status from the HSS for roaming VoLTE subscribers.

Custom MAP Callouts

Select the Custom flag if you are not looking for specific information. You can then use selective updates to customize the callout object after it is in the message. For more information, see the discussion about the example MAP ATI callout extension configuration in MATRIXX Call Control Framework Integration.

Note: Include only one custom query per Prerating profile. If multiple custom queries are attempted, only the result of the last query is stored.