Balances

A balance is a quantity of a currency or asset that is used for tracking and charging for service usage and service-related operations, such as recurring cycle fees.

Balance properties are defined in templates, and balance templates are derived from a balance class. You define both balance classes and balance templates during pricing plan creation. When you create a new balance, you must define a credit limit threshold for it. Pricing validation requires a credit limit threshold to be defined within the pricing repository for all balances.

Simple Balances and Meters

Simple balances and meters use one balance or meter instance for the entire validity period of the balance or meter. As rating occurs against the instance, the value can increase and decrease according to the applied charges, discounts, or grants.

By default, simple balances and meters are valid immediately and never expire. To limit their availability, you can set effective start and end dates. The end date can be set to indefinite, to a specific date, set after the specified time period relative to the start time or purchase time, or aligned with the end time of the catalog item that creates the balance or meter.
Important: End time alignment to a catalog item is for initialization only. If a balance or meter end time is aligned to a catalog item end time that is modified, an adjustment is required to that balance or meter because balance and meter end times do not track the purchased item cycle, billing cycle, and so on.

When the end date occurs, the instance is no longer valid and cannot be used.

A private balance end date (EndTime) can be modified through the MtxRequestSubscriberTopUpBalance SubMan API. A private balance start date (StartTime) cannot be modified.

Note: Private balance end dates track the purchased item cycle, billing cycle, and so on. This is to maintain the balance if the offer end date is extended and to prevent a private balance from remaining in the database once the owning offer is no longer valid.

For balances, you typically use the effective dates to grant subscribers prepaid assets that expire, but they can also be used for postpaid assets or currencies.

Subscribers and groups can have any number of simple balances in their wallets.

Asset Balances

Assets are financial non-monetary mediums of exchange, such as minutes and megabytes. Both represent a subscriber's liability to a service provider. If Include in Cost is selected in the asset balance, it is reported as a cost balance in SubMan responses and notifications.