- Subscription Management
The subscription management APIs include the messaging required to operate on the subscription object (MtxSubscriberObject), which is a primary object for MATRIXX interactions.
- Group Management
The group management APIs include the messaging required to operate on the group object. The APIs include the messaging and data elements required to create, modify, associate, and query objects directly related to the group.
- Device Management
The device management APIs include the methods and functions required to operate on the device primary object. They include the data elements required to create, modify, and query devices, to add and remove a device from a subscription, and to delete a device from the Subscriber database.
- User Management
The user management APIs include the messaging required to operate on the user object, which is a primary object for MATRIXX interactions. The API bindings include the messaging and data elements required to create, modify, and query users and associate a user with a subscription. A user can be associated with zero or more subscriptions and groups.
- Balance, Meter, and Wallet Management
The balance management APIs include the messaging required to operate on a balance, meter, or wallet object. The primitives include the messaging and data elements required to create, modify, associate, and query objects directly related to a balance or meter, including their thresholds.
- Product Offer and Bundle Management
The product offer management APIs include the messaging required to activate, purchase, cancel, and modify catalog items. You can identify a product offer by its object ID or the external ID assigned during pricing plan creation.
- Catalog Item Management
You can purchase, query, and cancel catalog items using the SubMan APIs.
- 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.
- Pricing Management
The pricing management APIs return information about all aspects of pricing, including catalog items, balance templates, product offers, billing cycles, life cycles, notifications and so forth. You can also get status information for the currently-loaded pricing.
- Rehoming
Rehoming is the process of moving a user, group, device, or subscription from one sub-domain to a different sub-domain in a multi-domain platform.
- RS Gateway Bulk Operations
The process_bulk_csv.py script reads comma-separated values (CSV) files to perform bulk REST operations through the RS Gateway.
- Object Validity End Time
The validity end time indicates the time after which querying an object again may return a different definition of the object.
- Purchased Item Cycle Alignment
When purchasing a catalog item, you can specify if the purchased item cycle is independent or aligned to a billing cycle, balance cycle, or a different purchased item cycle. The cycle to which a purchased item cycle is aligned is the master cycle.
- Offer Life Cycle Profiles
An offer life cycle profile consists of a set of offer statuses, a set of policies associated with each offer status that describe the behavior, and a set of transitions with the condition that triggers the transition and the actions to be performed. Both offers and bundles can have an offer life cycle profile defined. Use offer life cycle profiles to customize the behavior of MATRIXX Digital Commerce for your business processes.
- Status Life Cycles
A status life cycle is a collection of object states, properties and transition rules that are defined for a specific object type. You can define a status life cycle for user, device, subscription, group, and offer objects to customize the behavior of MATRIXX Digital Commerce for your business processes. For information about offer life cycles, see the discussions about offer life cycle profiles and offer life cycle status codes.
- Making Multiple Requests in One API Call
You can perform multiple engine requests (MtxRequestMulti
) using a POST call to the RS Gateway. For example, one request can create a subscriber, create a device, and associate the device with that subscriber.
- SubMan Operation Search Terms
In many of the SubMan API methods, you must specify a search term that identifies an instance of a specific object.
- Getting Subclasses of MDC Definitions
For each MDC definition, you can get a list of all classes that have that class as its base class.
- Getting Subtype Code Values
For each subtype, you can get a list of all codes and their values.
- Adding Event Data in SubMan Requests
You can pass data in SubMan requests in the MtxApiEventDataExtension MDC that will be included in EDRs.
- Working with Custom MDCs
Custom MDCs can stand alone or extend system MDCs or other custom MDCs. Use private MDCs to extend subscribers, devices, and purchased product offers with custom parameters. You can set values for these parameters in SubMan API calls within the <attr>
element of the request XML in the REST APIs or in the Attr
field of the Java APIs.
- Message XSDs
You can query the RS Gateway for XSD definitions for MDCs that can be used by third-party applications to validate their XML.