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