Biometric Verification

Face biometric verification to dukcapil database.

This module only support biometric verification for indonesian identity card (KTP)

Endpoints

Method

URL

POST

$synapses/v1/identity/verification/biometric

Headers

Header

Value

Content-Type

application/json

Authorization

Request

Field

Type

Description

identityId

(required)

String (len: 16)

Nomor induk kependudukan (NIK).

faceImage

(required)

Base64

Image binary encoded in base64 without <data:image/png;>. - Supports: JPG, JPEG, PNG, SVG - Max Size: 1MB

Testing

In the sandbox environment, we only response api call with dummy data. To get valid response data, you can use our production environment instead.

You can use identityId = 1234567890123456 to produce face not match result.

Example:

{
    "identityId": "1234567890123456",
    "faceImage": "<base64>"
}
{
    "message": "Identity biometric verification succeeded.",
    "data": {
        "id": "64d07984-81a8-4e79-ad16-a439f5885075",
        "identityId": "1234567890123456",
        "isValid": true,
        "isActive": true,
        "response": {
            "face": true,
            "faceSimilarity": 1.0
        }
    }
}

Response

Field

Type

Description

id

String

Unique identifier.

identityId

String

Nomor induk kependudukan (NIK).

isValid

Boolean

Return true if identityId is exist in the Dukcapil database.

isActive

Boolean

Return true if identityId is active in the Dukcapil database.

response:face

Boolean

Return true if input face match with the face in dukcapil database. - Default threshold: >= 0.75: True

response:faceSimilarity

Float (0-1)

Similarity between the input face and the face in Dukcapil database.

Errors

Please read this page <Responses & Errors> to know more about response.

Error 4XX

Error TypeDescriptionIs charged?

invalid_base64_encoding

Invalid base64 encoding.

False

image_too_large

Input image is greater than the maximum size allowed.

False

no_face_detected

No face was detected from the input image or the input image is blurry.

True

request_error

Cannot get response from Dukcapil server.

False

Error 5XX

For every 5XX http code response, there will be no charge.

Last updated