Home
MATRIXX Pricing and Rating
Rating
The following information describes MATRIXX Charging Application rating functionality.
Cycle Processing
The Charging Server supports balance cycles, billing cycles, and purchased item cycles.
Billing Cycle Management
Billing cycles properties are configured during global system configuration and managed using the SubMan APIs with which you can create or change a subscription or group billing cycle.
Creating and Changing Billing Cycles
Using the SubMan APIs, you can set parameters that affect the billing cycle.

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.
  - 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.
    - Recurring Processing
      Recurring processing can be triggered when MATRIXX Task Manager sends a message to the Charging Server because a trigger time in a subscriber or group wallet is reached.
    - Billing Cycles
      The billing cycle specification associated with a subscription is retrieved from a predefined billing profile template in the subscription wallet. The template is created as part of pricing configuration and forces all billing cycle pricing associated with the subscription to be applied with the same cycle settings. Each wallet can contain only one billing profile template. Define billing cycles in billing profile templates in My MATRIXX.
    - Billing Cycle Management
      Billing cycles properties are configured during global system configuration and managed using the SubMan APIs with which you can create or change a subscription or group billing cycle.
      - Creating and Changing Billing Cycles
        Using the SubMan APIs, you can set parameters that affect the billing cycle.
      - Enabling and Disabling Billing Cycles
        When a subscriber is suspended, all subscriber-owned catalog items might be suspended or canceled. Therefore, billing might be suspended. In these situations, you might want to disable the subscriber billing cycle.
    - Balance Cycles
      You can define balance cycles in balance templates.
    - Purchased Item Cycles
      A purchased item cycle is a recurring processing cycle assigned to a purchased catalog item. The purchased catalog item is a purchased item or bundle. If the purchased item represents a bundle with multiple offers, all offers in the bundle are aligned to the same purchased item cycle.
- 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

Creating and Changing Billing Cycles

Using the SubMan APIs, you can set parameters that affect the billing cycle.

You can specify the following parameters for a billing cycle using the SubMan APIs:

DateOffset — The offset within the billing period if the BillingDatePolicy has a specific offset value. If not present, then the start of the billing period is used.
ImmediateChange — Applies only when the billing cycle is changed. Set the value to true to have the change take effect in the current period. This option is applicable for period types weekly, monthly, and yearly.
Depending on the new offset and the day when the change request is made, the current period could be terminated on the day before the new offset, and the next period starts on the new offset. Or, the current period is not terminated, but the next period is a short period, ending on the new offset.

For more information about billing cycles, see the discussion about billing cycles in MATRIXX Pricing and Rating.

When a billing cycle is changed, an MtxBillingCycleChangeEvent Event Detail Record (EDR) is generated. If the current cycle is shortened, an MtxPeriodTerminationEvent EDR is generated. The period termination proration policy defined in product offer cycle data is applied to generate refunds and forfeitures for the terminated period. If the CycleType is 3 (purchased item cycle), information about the purchased item, offer, or bundle is included in the OfferInfoArray or BundleInfoArray, respectively. If the purchased item is a bundle, information for all offers in the bundle is included in the OfferInfoArray. For information about MtxBillingCycleChangeEvent, see MATRIXX Integration.

Use the following SubMan APIs to add or change billing cycles:

SubscriptionCreate (POST /subscription)
GroupCreate (POST /group)
SubscriptionModify (PUT /subscription)
GroupModify (PUT /group)