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