Argos KYC
KYC VER 2.0 Service
Anti Money Laundering
Developer Guide - API
KYC VER 2.0 Developer Guide
API Guide (Deprecated)
Korean ID FAQ
Q. What is ID authenticaion?
ID authentication checks the authenticity of South Korean Driver's license and government ID(Jumin-deunglogjeung) by combining ID info and personal info.
The collected information is compared to the government database. Through this procedure, Argos KYC clarifies whether the information is actually registered.
Authentication API service works as theft prevention of ID cards and personal information. This is because forged identities cannot find matching results in government databases.
Passed authenticity means "confirmed identity information of an existing person."
Q. Why is authentication needed?
ID theft prevention
Argos KYC Athentication API service compares the ID information with the government database. We check if there is matching data with collected personal info and detect forged ID cards.
This is because if you tamper with someone else's ID card or create one that does not exist, you can not pass authentication since there's no matching information in the government database.
Ease to initialize
Argos KYC Athentication API service does not require additional development or software installation. You can simply get and post information with API and check the results within seconds.
*Data Source
ID Type
Data Source
Web page
Government ID
(Jumin-deunglogjeung)
Ministry of the Interior
and Safety
Q. How to use API when collecting Resident Registration Number?
Resident registration numbers can be collected from approved institutions. If you need to collect resident registration numbers, first request to collect resident registration numbers through HELPDESK. If there is no request, Argos KYC does not collect resident registration numbers under the Personal Information Protection Act by default.
If the collection request is accepted, if you submit your ID card (passport, resident registration card, driver's license) with POST/submission/step1, the "identityNumber" value will be included as a response if the ID is normally recognized. "identityNumber" means the resident registration number. "identityNumber" can be used to verify authenticity in step 2.
Q. What happens in case resident registration number is not collected?
When resident registration numbers are not collected, it follows the following process.
Resident registration number Masking
If the resident registration number cannot be collected, the back 7 out of 13 resident registration numbers will be automatically masked.
*The first 6 digits correspond to the date of birth and cannot be masked.
Skipping authenticity verification
The verification of the authenticity of the Korean resident registration card and driver's license must be accompanied by the collection of 13 digits of the resident registration number. If the resident registration number cannot be collected, the "skip" process will be applied to the authenticity check.
*If the "Skip" process is applied, authenticity verification does not affect KYC results.
Q. Resident Registration Card?
The resident registration card is verified with the "fullName", "resident registration number" and "issuance date".
The resident registration number and issued date can be checked by step 1's response if the ID card is normally recognized in step 1.
If you submit the issuance date to date_of_issue and your resident registration number to the identity_number as input parameters in step2, you can receive the "verificationResult" value as a response.
If "verificationResult" indicates success, authenticity verification is successful, and if it indicates fail, it means there is either forgery or incorrect resident registration numbers.
1. Government ID Check Request Arguments
Argument
Description
Required
type
“government_ID”
Required
issueDate
Date of issue (YYYY-MM-DD )
Required
fullName
Fullname (in Hangeul, Korean alphabet)
Required
identity
13 digits unique identification number
( 880913-1xxxxxx )
Required
2. Government ID Check Response
Parameter
Description
Result
authenticity
Authentication result
Pass / Fail
authenticityDesc1
Additional description 1
*Warning
If more than 5 ID check attempts are made on a single ID number, further ID checks on the same ID number are prohibited and locked until the ID owner unlocks it. Please make sure not to make too many invalid ID check requests.
When the account is locked, only the owner can unlock it.
Q. Korean Driver's License?
The driver's license is verified with the "Driver's License Registration Number", "Serial Number", and "birthDate".
The driver's license number(license_number) and resident registration number(identity_number) can be checked by step1's response if the ID card is normally recognized in step1.
However, serial number(serial_number) is not recognized. The serial number means a small 6-digit code at the bottom right of the driver's license. Serial number can be collected through a separate method such as user input.
1. Driver’s License Check Request Arguments
Argument
Description
Required
type
“driver_license”
Required
fullName
Fullname (in Hangeul, Korean alphabet)
Required
document
12 digit number (12-34-567890-12 )
or
Region name with 10 digit number
(서울-12-345678-90)
Required
birthDate
Date of birth (YYYY-MM-DD )
Required
serialNo
6 digit code on driving license (ex. 11YY22 )
Required
2. Driver’s License Check Response
Parameter
Description
Result
authenticity
Authentication result
Pass / Fail
authenticityDesc1
Additional description 1
authenticityDesc2
Additional description 2
Copy link
Contents
Q. What is ID authenticaion?
Q. Why is authentication needed?
Q. How to use API when collecting Resident Registration Number?
Q. What happens in case resident registration number is not collected?
Q. Resident Registration Card?
1. Government ID Check Request Arguments
2. Government ID Check Response
*Warning
Q. Korean Driver's License?
1. Driver’s License Check Request Arguments
2. Driver’s License Check Response