Get eKYC Details

To retrieve eKYC details ( OkayID, OkayLive, OkayFace, OkayDoc, Scorecard) for a journey

Overview

The user is required to enter the username and password under the API Header provided by Innov8tif Solutions.

API Method

To get the full journey details including OCR results from OkayID, processed result from OkayFace, OkayLive, and OkayDoc

GET https://ekycportaldemo.innov8tif.com/api/ekyc/details/{journeyId}

Headers

Name	Type	Description
Authorization*		Basic base64(USERNAME:PASSSWORD) e.g. dGVzdGVyOnRlc3QxMjM0 Get the USERNAME and PASSWORD from Innov8tif Solutions encode base64 with the USERNAME and USERNAME

200: OK A encrypted response will be returned

To decrypt the response

Online tool: https://www.devglan.com/online-tools/aes-encryption-decryption

Decrypt value from result in JSON response using algorithm AES 128

· Initialization Vector (IV) = byte array of key that provided by Innov8tif Solutionss

· Cipher= AES/CBC/PKCS5PADDING

Encrypted Form
{
    "status": "success",
    "message": "api.success",
    "result": "p1GWGOfIXaDKD6............"
}


Decrypted Form
{
"id": "6e9054f0-4e25-4bb3-958b-d96c75fd2b34",
	"createdDate": 1697438472000,
	"companyId": "iPt4dDiN0lBLhnpimTPZhRP-huvZKyx-",
	"okayDocs": [
		{
			"id": "b0f22434-0855-4f2c-a003-64e86edb6605",
			"docType": "ektp_front",
			"okayDocResponse": {
				"status": "success",
				"messageCode": "api.success",
				"message": "",
				"id": "b3be9693-3879-4ebd-8c1f-5489002b11c0",
				"methodList": [
					{
						"method": "landmark",
						"label": "Landmark Analysis Result",
						"componentList": [
							{
								"code": "l-ektp-front-nik",
								"label": "Nik",
								"value": "66.08650088310242",
								"imageUrl": "/public/image/v2/b3be9693-3879-4ebd-8c1f-5489002b11c0?type=l-ektp-front-nik"
							},
							
							
............							
}

API Response

status

Indicate API status. Values can be Success or Error.

message

Status message if the status is an error. INVALID_AUTH_HEADER– invalid authentication header. WRONG_CREDENTIAL – invalid username or password. INVALID_JOURNEY_ID – invalid journeyId AUTHORIZATION_ERROR – authorization error: when journeyId doesn’t belong to the requested username/password ERROR_NO_PERMISSION – indicate control ‘Allow journey deletion via API’ is disabled ( in IDV module for each account)