Account Validation
https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
https://auth.zamupay.com
POST
/v1/kyc-request/validate
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 |
Sample response
{
"systemTraceAuditNumber": "95156e7a-16f4-4973-964b-a01f610a4b66",
"message": "Request Accepted. Kindly await processing"
}Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://auth.zamupay.com/v1/kyc-request/validate' \
--header 'Content-Type: application/json' \
--data '{
"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
}'Response Response Example
{
"systemTraceAuditNumber": "95457e7a-16f4-4973-964b-a01f610a4b66",
"message": "Request Accepted. Kindly await processing"
}Modified at 2026-04-20 08:14:31