Skip to main content

Compliance Use Cases

What is a Use Case?

Within the GSMA Mobile Money API Compliance Platform, "Use Cases" (UC) represent the different goals that actors within the system may have. For example, a peer-to-peer (P2P) transfer of money would constitute a use case, as would payment to a merchant for some service. Use cases capture the business and user requirements to demonstrate precisely what to expect from the system. A use case includes all possible paths through a given user/system interaction - both the primary and alternative flows for all use case scenarios defined for the API use case.

The primary path (also called happy flow) is the main flow to be tested, where it is possible to satisfy all user needs. Alternative paths include several other situations that are related to the use case, even if they are not desired, or less frequent. These alternative flows often include errors, and are also called unhappy flows. Each of these flows is represented by a "Test Case" within the platform.

This section of the documentation includes more information about use cases in general, and about the use cases which the GSMA have made available to test within the GSMA Mobile Money API Compliance Platform. To see more about the different paths available to test within each use case, please see the list of available test cases.

Transaction Elements

The use cases represent the different kinds of Mobile Money transactions available for testing in the platform. Each use case is composed of a set of transaction elements which are used to define its main characteristics. These elements are:

Transaction Scenarios: A Transaction Scenario represents one of the several ways of using mobile money and is directly related to the objective that the use case validates.

Initiating Party: The Initiating Party specifies the actor who initiated the transaction.

Initiator Type: The start of the transaction can occur from different sources that are defined by Initiator Type. This source also limits the types of transactions that can occur.

Transaction ScenariosInitiating PartyInitiator Type
WithdrawalService ProviderDevice
PaymentMobile Money API ProviderAgent

These elements can be combined in different ways to define the use case under evaluation. For example, in a merchant-initiated merchant payment transaction we the Transaction Scenario would be "payment", the Initiating Party would be "payee" and the Initiator Type would be "business. If the transaction was initiated by a POS, the type would change to "device".