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)	Type	Description
last4Digits*	string	Last 4 Digits of card associated with phone number
mobilePhoneNumber*	string	Mobile 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
}

Field	Type	Descirption
address1	string	This field contains the Card holder address1
address2	string	This field contains the Card holder address2
address3	string	This field contains the Card holder address3
alternatePhoneNumber	string	This field contains the secondary Mobile Phone Number
birthDate	string	This field contains on Format: DD-MMM-YYYY (17-JAN-1985)
cardStatus	string	This field contains the Card Status
cardType	string	This field contains the Card type. VPC or VCC
city	string
country	string	This field contains the Two character country code
emailAddress	string
errorCode	string	Error Code
errorMessage	string	Error Message
firstName	string
idType	string	This field contains the “PASSPORT”, “NATIONAL_ID”,“DRIVERS_LICENSE”,“ALIEN_CARD”, “VOTER_ID”, “SSNIT”, “NATIONAL_ID_NO_PHOTO”,'OTHER' corresponding to the API request
idValue	string	The Value corresponding to the idValue
l4	string	This field contains last 4 digit of card
lastName	string
middleName	string
mobilePhoneNumber	string	This field contains the primary Mobile Phone Number
otherCustomerID	string	This field contains the Card holder otherCustomer ID
postalCode	string
preferredName	string
solId	string	This field contains the branch ID if exists
stateRegion	string	This field contains the Two character State/Region code specific to Country
subCompany	string	This field contains the Sub Company of the partner