Card Balance

Balance Request service uses the POST method to display the available balance of the registered card and its corresponding currency code. Balance can be retrieved for cards in PreActive, Active and Inactive status only.

Endpoint

/MFSAfricaCard/v1/balancerequest

Request

{
  "last4Digits": "9198",
  "mobilePhoneNumber": "256123456789"
}

Field (* required field)	Type	Description
last4Digits*	string	Last 4 Digits associated with card
mobilePhoneNumber*	string	Mobile Number associated with card

Response

{
    "balance": 60000.0,
    "currencyCode": "UGX",
    "errorCode": "0000",
    "errorMessage": "SUCCESS"
}

Field	Type	Description
balance	string	The balance on the customer’s account
currencyCode	string	The three character ISO 4217 Currency Code of the customer’s account
errorCode	string	Error Code
errorMessage	string	Error Message