Upgrade to OAS version 3

Mobile Money API version 1.1 has been developed using OAS version 3 to take advantage of the new modelling and schema reuse capabilities that OAS3 provides. This has led to significant reuse of schemas/properties and has significantly improved readability.

 

Overhaul of Callback mechanism

In version 1.0 of the mobile money API, callbacks were issued via a patch command with clients unable to specify a URL to receive the callback. In version 1.1, the following improvements have been made:
o The client can specify full callback URL using a new request header X-Callback-URL.
o A full representation of the created resource is sent back (via PUT) in response to a successful creation request.
o Mobile Money API callbacks have been modelled using callback operations introduced in OAS v3.

 

Improved implementation of identifier types in path

The Mobile Money API now permits any Identifier Type in path, not just MSISDN:
o Original version 1.0 implementation: /accounts/msisdn/{msisdn}/
o New version 1.1 implementation: /accounts/{identifierType/{identifier}/

 

New APIs for Bill Companies

New set of APIs to enable clients to retrieve Bill Company information.

 

New Authorisation Codes APIs

Provide the ability to generate & cancel transaction authorisation codes which can expire.
Provides support for ATM withdrawals & voucher code-based transactions.

 

New API - POST /transactions/type/{transactionType]

Enables the transaction type to be identified in the URL when creating a transaction.
This is required in some API Gateway implementations to allow fine grained API permissions to be applied.

 

Account Balance ‘Self’ API

Added new ‘self’ API for account balance, removing the need for the account subject to identify itself in the path.