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)TypeDescription
last4Digits*stringLast 4 Digits associated with card
mobilePhoneNumber*stringMobile Number associated with card

Response

{
    "balance": 60000.0,
    "currencyCode": "UGX",
    "errorCode": "0000",
    "errorMessage": "SUCCESS"
}
FieldTypeDescription
balancestringThe balance on the customer’s account
currencyCodestringThe three character ISO 4217 Currency Code of the customer’s account
errorCodestringError Code
errorMessagestringError Message