MVNX API

Allows MVNOs to manage service allocations associated with prepaid subscribers.

Use Cases

These are some examples of using the TMF 654 APIs for managing prepaid subscribers:

• Adjustment: An Adjustment request either credits or debits a subscriber’s main account balance. The subscriber’s airtime expiration date is not impacted by an Adjustment. Requests to debit a subscriber’s main account balance below $0 or credit a subscriber’s main account balance past the maximum main account balance limit will not be allowed.

• Retrieve Account Details: This request is used to retrieve details about a subscriber’s account, e.g., account status, account balance, rate plan, etc. The Retrieve Account Details request is resource intensive and must be used judiciously.

• Update Airtime Expiration Date: An Update Airtime Expiration Date request is used to update the airtime expiration date on a subscriber’s account.

• Update Service Package: An Update Service Package request is used to increase, decrease, or set the service balances of Service Based and Flexible Refill rate plans. It is also used to set the Dynamic Tier service refill amounts for Flexible Refill rate plans.

• Change Auto Renew: A Change Auto Renew request is used to enroll or de-enroll subscribers in the Auto Renew feature.

• Payment: A Payment request adds money to the subscriber’s main account or subscriber’s bucket and MAY extend the subscriber’s airtime expiration date. TPSP Payment must be used to activate the subscriber’s lifecycle.