Account Validation

This endpoint performs customer identity verification using provided KYC details.

Use the Find Transaction Routes endpoint to get the routeId

Sample request

{

    "routeId": "efazae34-3fc5-f001-bbc1-0e34952d7n37",
    "kycRequestFirstName": "Ian", // mandatory
    "kycRequestMiddleName": "Murithi",
    "kycRequestLastName": "Njuguna",  
    "kycRequestOtherNames": "",
    "kycRequestNationalID": "34237005",
    "CustomerAccountSerialNo": "00980",   // mandatory
    "kycRequestPassportNo": "",
    "kycRequestServiceID": "{{$guid}}",
    "kycRequestAlienID": "string",
    "kycRequestTaxID": "string",
    "kycRequestDateOfBirth": "2019-08-24T14:15:22.123Z",
    "kycRequestPostalBoxNo": "string",
    "kycRequestPostalTown": "Kangemi",
    "kycRequestTelephoneMobile": "string",
    "kycRequestPhysicalAddress": "Nairobi",
    "kycRequestPhysicalTown": "Nairobi",
    "kycRequestPhysicalCountry": "Kenya",
    "kycRequestReportReason": 0,
    "kycRequestCallBackURL": "https://strong-deer-12.webhook.cool",
    "deviceId": "A45494",
    "systemTraceAuditNumber": "{{$guid}}",
    "country": "KEN",
    "ccy": 404
}

Field Name	Data Type	State
routeId	string	Mandatory
kycRequestFirstName	string	Mandatory
kycRequestMiddleName	string	Mandatory
kycRequestLastName	string	Mandatory
kycRequestOtherNames	string	Optional
kycRequestNationalID	string	Mandatory
serialNo	string	Optional
kycRequestPassportNo	string	Optional
kycRequestServiceID	string	Optional
kycRequestAlienID	string	Optional
kycRequestTaxID	string	Optional
kycRequestDateOfBirth	string	Optional
kycRequestPostalBoxNo	string	Optional
kycRequestPostalTown	string	Optional
kycRequestTelephoneMobile	string	Optional
kycRequestPhysicalAddress	string	Optional
kycRequestPhysicalTown	string	Optional
kycRequestPhysicalCountry	string	Optional
kycRequestReportReason	string	Mandatory
kycRequestCallBackURL	string	Optional
deviceId	string	Optional
systemTraceAuditNumber	string	Mandatory
country	string	Mandatory
ccy	string	Mandatory

NOTE: Once access to the API has been granted, the routeID will be shared.

Sample response

{
    "systemTraceAuditNumber": "95156e7a-16f4-4973-964b-a01f610a4b66",
    "message": "Request Accepted. Kindly await processing"
}

curl --location --request POST '/v1/kyc-request/validate' \ --header 'Content-Type: application/json' \ --data-raw '{ "routeId": "string", "kycRequestFirstName": "string", "kycRequestMiddleName": "string", "kycRequestLastName": "string", "kycRequestOtherNames": "string", "kycRequestNationalID": "string", "serialNo": "string", "kycRequestPassportNo": "string", "kycRequestServiceID": "string", "kycRequestAlienID": "string", "kycRequestTaxID": "string", "kycRequestDateOfBirth": "2019-08-24T14:15:22.123Z", "kycRequestPostalBoxNo": "string", "kycRequestPostalTown": "string", "kycRequestTelephoneMobile": "string", "kycRequestPhysicalAddress": "string", "kycRequestPhysicalTown": "string", "kycRequestPhysicalCountry": "string", "kycRequestReportReason": 0, "kycRequestCallBackURL": "string", "deviceId": "string", "systemTraceAuditNumber": "string", "country": "string", "ccy": 0 }'

Sample request#

Sample response#

Request

Responses

Sample request

Sample response