Customer Search

Customer Search Request service uses POST method to retrieve the cardholders full name as mentioned in the account, Client / Partner specific ID, 6 digit BIN of the card, last 4 digits of the 16-digit PAN and the card status.

Endpoint

/MFSAfricaCard/v1/customerSearchRequest

Request

{
  "phoneNumber": "256123456789"
}

Field (* required field)

Type

Description

phoneNumber*

string

Mobile Number associated with customer

Response

{
    "accountInfoList": [
        {
            "accountId": "12702380",
            "bin": "880088",
            "lastFourDigits": "8091",
            "firstName": "John",
            "middleName": null,
            "lastName": "Doe",
            "status": "AC"
        }
    ],
    "errorCode": "0000",
    "errorMessage": "SUCCESS"
}

Field

Type

Description

accountInfoList

object

"accountInfoList": [
{
"accountId": "string",
"bin": "string",
"firstName": "string",
"lastFourDigits": "string",
"lastName": "string",
"middleName": "string",
"status": "string"
}
]

errorCode

string

Error Code

errorMessage

string

Error Message