Identity Verification
This service enables identity verification across various ID types such as Driver's license, NIN, BVN and International passport.
This endpoint verifies identity details such as :-
- first name
- last name
- Address
- phone number
- date of birth
- Anti money laundry (AML)
- Bank account number
- bank code
Process Flow
Step one :- Make a POST request to Verification endpoint.
Please note
The type field should be set to INDIVIDUAL. The verificationRequests field is an array that carries the various identification types and their related values.
Sample Request
curl https://kyc-service.k8.isw.la/api/v1/verifications \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{
"type": "INDIVIDUAL",
"phone": "08030000000",
"lastName": "Doe",
"firstName": "John",
"birthDate": "1990-01-01",
"verificationRequests": [
{
"type": "ADDRESS",
"buildingNumber": "15B",
"street": "Oko Awo Street",
"landmark": "Eko Hotel",
"city": "Victoria Island"
"state": "NG-LA",
"country": "NGA",
"base64EncodedImage": "/9j/4AAQSkZJRgABAQEASABIAAD//gBcYm9yZGVyIGJzOjAgYmM6IzAwMDAwMCBwczowIHBjOiNlZWVlZWUgZXM6MCBlYzojMDAwMDAwIGNrOjUwMGQwMmE0ZjFmMWQ3NDk3MzQwY2M1ODY4OTZiZjEx/9sAQwAGBAUGBQQGBgUGBwcGCAoQCgoJCQoUDg8MEBcUGBgXFBYWGh0lHxobIxwWFiAsICMmJykqKRkfLTAtKDAlKCko/9sAQwEHBwcKCAoTCgoTKBoWGigoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgoKCgo/8AAEQgAGQAZAwEiAAIRAQMRAf/EABgAAQADAQAAAAAAAAAAAAAAAAcEBQYI/8QAMRAAAgECBAQEAgsAAAAAAAAAAQIDBBEABQYSByExQRMUIlEVczI2YWJxcpGTsbLC/8QAFgEBAQEAAAAAAAAAAAAAAAAAAgME/8QAHREAAQUAAwEAAAAAAAAAAAAAAQACAwQREyEiMf/aAAwDAQACEQMRAD8AvuJPGqo0trd9MZZp1qidCiNV1cjRoWcCxVQvNBceq/Pn+OMtFrYfHJqTV1I1JVs1jVbyyqe28AEhelmUkWt6SOYbOONXDRcP2jrL+VqauGKRhzKAN4gKjudyKLfbgyjoNMapmarcJVNTRKiwvuVlFjtuORHL39sRfYMLlpjottRnT2q3I9Z1eU8QsgytJoJaWsZaasjp5N8bNKwWN1IuLg7TuHVW/R48I4EuHOkcqqtWxZzFEhnaqM9LAG2JTww7VLBB1Jaxv95e/PDnY4Yl5fQUpKxrYwnVA4uZM2p9CZhk9FLTLmMjQy04mJsHSRXHQEi4Ui9u+OZpct1lUZjPl9ZFDSeUJpGnEgbaqsVIS3Nu9rjucdXZZ9E/NP8AbB1qf635l8wfwcRsnG6tVEFzi3elUcJcuqMq1E0NPRGeGSjMTylvVCqnde563Jtblzt7YT/Ow+037bYi8Nutf+VP9Y0uFVGxglG9nMQBnxf/2Q=="
},
{
"type": "AML",
"country": "NGA"
},
{
"type": "BVN",
"identityNumber": "11111111111"
},
{
"type": "DRIVERS_LICENCE",
"identityNumber": "AAA22222A01",
"country": "XXX"
},
{
"type": "NIN",
"identityNumber": "33333333333",
"documents": [
{
"fileName": "fNW12s8fXEwexxIM71weMQeu4.png",
"description": "NIMC Slip"
}
]
},
{
"type": "PASSPORT",
"identityNumber": "A44444444"
},
{
"type": "BANK_ACCOUNT",
"accountNumber": "0696363603",
"bankCode": "044",
"country": "NGA"
}
],
"callbackUrl": "http://localhost:8080"
}'
-X POST
Sample Response
{
"verificationResponses": [
{
"type": "ADDRESS",
"status": "PENDING",
"lastName": "Doe",
"firstName": "John",
"birthDate": "1990-01-01",
"phone": "+2348030000000",
"buildingNumber": "15B",
"street": "Oko Awo Street",
"landmark": "Eko Hotel",
"city": "Victoria Island",
"state": "Lagos",
"country": "Nigeria",
"reference": "ISW|KYC|ADD|20200122|P64JHM1H7"
},
{
"type": "AML",
"status": "NO MATCH",
"kycDomain": "ISW",
"amlMatches": [],
"reference": "ISW|KYC|AML|20200122|09390527R"
},
{
"type": "BVN",
"status": "VERIFIED",
"identityNumber": "11111111111",
"lastName": "Doe",
"firstName": "John",
"birthDate": "1990-01-01",
"reference": "ISW|KYC|BVN|20200122|5ZSOLLU1V"
},
{
"type": "DRIVERS LICENCE",
"status": "FAILED",
"reference": "ISW|KYC|DLN|20200122|C1S7BGOUX",
"failureCode": "bad_request",
"failureDescription": "Request is not valid. Possible syntax, data type mismatch, or field validation errors",
"errors": [
{
"field": "country",
"message": "invalid - expected: iso alpha-3 country code"
}
]
},
{
"type": "NIN",
"status": "NOT VERIFIED",
"identityNumber": "33333333333",
"lastName": "Doe",
"firstName": "John",
"birthDate": "1990-01-01",
"reference": "ISW|KYC|NIN|20200122|P4R9SLNMA"
},
{
"type": "PASSPORT",
"status": "FAILED",
"reference": "ISW|KYC|PPT|20200122|FLL3THDBE",
"failureCode": "bad_request",
"failureDescription": "Request is not valid. Possible syntax, data type mismatch, or field validation errors",
"errors": [
{
"field": "country",
"message": "required"
}
]
},
{
"type": "BANK ACCOUNT",
"status": "NOT VERIFIED",
"country": "Nigeria",
"reference": "ISW|KYC|BAC|20200511|MAEI5JMVB"
}
]
}
Reference
Updated about 3 years ago