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 |
Updated over 1 year ago