Customer Data

Customer Data Request service uses POST method to retrieve the cardholder data such full name, name printed on the card (if supplied), Client / Partner specific ID, full address, date of birth, registered KYC details, registered an alternate mobile number, registered email id, sub-company & card status as mentioned in the account.

Endpoint

/MFSAfricaCard/v1/customerDataRequest

Request

{
  "last4Digits": "1234",
  "mobilePhoneNumber": "256256123456789"
}
Field (* required field)TypeDescription
last4Digits*stringLast 4 Digits of card associated with phone number
mobilePhoneNumber*stringMobile Number associated with card

Response

{
    "errorCode": "0000",
    "errorMessage": "SUCCESS",
    "firstName": "John",
    "middleName": null,
    "lastName": "Doe",
    "preferredName": "John Doe",
    "otherCustomerID": null,
    "address1": "Uganda",
    "address2": null,
    "address3": null,
    "city": "Kampala",
    "country": "UG",
    "stateRegion": "Kampala",
    "postalCode": "000001",
    "birthDate": "07-JUN-1997",
    "idType": "4",
    "idValue": "00000000000000",
    "mobilePhoneNumber": "256123456789",
    "alternatePhoneNumber": null,
    "emailAddress": "[email protected]",
    "solId": null,
    "subCompany": "12700123",
    "cardStatus": "AC",
    "cardType": "VPC",
    "l4": null
}
FieldTypeDescirption
address1stringThis field contains the Card holder address1
address2stringThis field contains the Card holder address2
address3stringThis field contains the Card holder address3
alternatePhoneNumberstringThis field contains the secondary Mobile Phone Number
birthDatestringThis field contains on Format: DD-MMM-YYYY (17-JAN-1985)
cardStatusstringThis field contains the Card Status
cardTypestringThis field contains the Card type. VPC or VCC
citystring
countrystringThis field contains the Two character country code
emailAddressstring
errorCodestringError Code
errorMessagestringError Message
firstNamestring
idTypestringThis field contains the “PASSPORT”, “NATIONAL_ID”,“DRIVERS_LICENSE”,“ALIEN_CARD”, “VOTER_ID”, “SSNIT”, “NATIONAL_ID_NO_PHOTO”,'OTHER' corresponding to the API request
idValuestringThe Value corresponding to the idValue
l4stringThis field contains last 4 digit of card
lastNamestring
middleNamestring
mobilePhoneNumberstringThis field contains the primary Mobile Phone Number
otherCustomerIDstringThis field contains the Card holder otherCustomer ID
postalCodestring
preferredNamestring
solIdstringThis field contains the branch ID if exists
stateRegionstringThis field contains the Two character State/Region code specific to Country
subCompanystringThis field contains the Sub Company of the partner