IdentifAI Dukcapil Validation aims to validate the facial biometric identity of an individual through the National ID Database (Dukcapil). We can do this thanks to our cutting-edge technology and Agreement with Indonesia's Ministry of Home Affairs who oversees the National ID Database.
Below are some of our key technology & platform:
Face Match [1:1] --> Comparing two photos containing facial biometric information, through AI and Face Recognition Technology, we can define their level of similarities.
Our computational platform for face-matching is operated on-premise in Dukcapil's environment.
The Shared-Platform (Platform Bersama) is an interface managed by the appointed agency (where Nodeflux is one of the appointees) and served as a bridge in validating the data to Dukcapil's National ID Database.
Please ensure you are authorized to access the Dukcapil Platform Bersama. The Dukcapil credentials data are identifier data used to validate that users actually get access rights to use the Dukcapil Platform Bersama. Without sending the credential data, the Rest API call will be rejected by the system. You need to fill your credentials in the IdentifAI dashboard such as:
Dukcapil Agreement Number (Nomor PKS)
The agreement number is stated in your Dukcapil Agreement letter for accessing face bimetric service
Dukcapil Agreement expiration date
Expiration date of Dukcapil Agreement that state in the agreement letter
Dukcapil Customer ID
The unique profile name of and institution that has been approved by Dukcapil
Dukcapil User ID
The unique username of and institution that is given by Dukcapil
The password is given by Dukcapil as an authorization of rights service access.
For the privacy and the security consent, the submitted credential will be encrypted in our system
API Sequence Diagram
To use the service, you have to encrypt your image parameter and the credential for security purpose. Here are the sequences of how to do encryption and use the API.
Client requests payload parameters encryption API directly to DUKCAPIL GATEWAY with clients’ private connection.
DUKCAPIL GATEWAY provides an encrypted parameter to the Client.
The encryption step will return encrypted credential and image
Request Face Matching Service
Face matching request on Platform Bersama is sent via Nodeflux Gateway (IdentifAI Dukcapil Validation API) which is made by each client containing information on NIK, User ID, Password, and Face Photo.
User ID, Password, and Face Photo information is encrypted from step 1,
NIK information is sent without encryption.
Nodeflux gateway checks the service activation and registered client's Dukcapil Gateway URL. The URL information will be retrieved from your dashboard. Please complete your account information by filling authorized URL from Dukcapil on dashboard.identifai.id.
NODEFLUX GATEWAY forwards the Client requests to DUKCAPIL GATEWAY.
Before entering into the matching process on the FACE MATCHING SERVER, Dukcapil decrypts payload parameter: User ID, Password, and Face Photo information;
After the decryption process, the NIK information and Face Photo are sent to the FACE MATCHING SERVER for the matching process;
The face matching process is carried out on the FACE MATCHING SERVER will return similarity value.
The similarity value is sent from MATCHING SERVER to DUKCAPIL GATEWAY;
Nodeflux Gateway will return job_id to the client.
To get the result, the client should Request GET status by job_id.
Nodeflux Gateway will return the similarity result.
"message": "Unable to read image data, please provide image data on the correct field",
4xx: No image value on image parameter
"Please provide 1 image(s) for DUKCAPIL_VALIDATION to proceed"
"message": "The total image(s) provided is not valid",
4xx: Insufficient quota from Dukcapil
"message": "Your daily quota hit on Dukcapil Gateway is insufficient, please contact Dukcapil for additional Quota",
5xx: NIK Data not Found
Note: The NIK data might be not found because the image data has not been extracted yet on our database. However, we will do regularly update if there is any new citizen data on Dukcapil. This error is not charged by our system.