Documentation Index
Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
Use this file to discover all available pages before exploring further.
2026-04-29
Submission 응답에 영문 이름(full_name_en) 추가
ID_Check v2.3.0KYC 승인 시점에 제출자의 Full Name 을 영문으로 변환한 full_name_en (DB: fullNameEn) 필드가 Submission 응답·웹훅·대시보드 상세에 추가되었습니다. 음역(transliteration) 으로 처리되며 의역하지 않습니다 (예: 김 산 → KIM SAN). First/Last name 은 변환되지 않으며, 라이브폼 단계와 비교 로직 대상이 아닙니다.- 2026년 4월 업데이트 — full_name_en 추가 제품 업데이트
- GET/Submission 응답 필드 정의 참조
- 사용자 제출건 대시보드 가이드
라이브폼 스트리밍 — 업로드 이미지 Quality Check 옵션
LiveForm v2.2.0라이브폼 스트리밍 촬영만 진행 + 신분증 업로드 허용 ON 상태에서 업로드 이미지에 적용할 Image Quality Check 토글이 추가되었습니다. 기본값 ON 으로 FE IQC 를 수행하며, OFF 로 전환 시 업로드 이미지 IQC 를 스킵합니다.- 2026년 4월 업데이트 — IQC 옵션 제품 업데이트
- 인증강화 및 위조방지 — 라이브폼 스트리밍 촬영만 진행 대시보드 가이드
startValidUntil — 인증 시작 전 유효시간 설정
ID_Check v2.3.0LiveForm v2.2.0쿼리스트링 옵션 startValidUntil 이 추가되어, 인증 시작 전에 링크 자체를 만료시킬 수 있습니다. UTC+0 / 암호화 필수 / 토큰 검증보다 먼저 평가됩니다. 만료된 상태로 접근하면 신규 에러 코드 PV-40018 로 이동합니다.- 2026년 4월 업데이트 — startValidUntil 제품 업데이트
- 쿼리 스트링 및 토큰 가이드 개발자 가이드
- 에러 코드와 에러 페이지 — PV 참조
2026-04-24
Device Info 탭 신설과 Fingerprint option 추가
ID_Check v2.2.0LiveForm v2.1.0인증강화 및 위조방지 설정이 3탭 구조로 확장되었습니다. 기존 Device Verification 옵션은 신규 Device Info 탭으로 이동되었고, 디바이스 Fingerprint 기반의 Fingerprint option (가상 머신 / 에뮬레이터 / 악성 봇 / 브라우저 변조 탐지)과 Device 중복 검사가 추가되었습니다. Device Info 검증은 라이브폼 진입 시 가장 먼저 수행됩니다.- 신규 에러 코드
DE-30000(Fingerprint 탐지),DE-40000(Device 중복 초과) 추가 - 2026년 4월 업데이트 — Device Info 제품 업데이트
- 인증강화 및 위조방지 — Device Info 대시보드 가이드
- Device Verification 사전 검증 목록 대시보드 가이드
정부데이터 확인 파이프라인 신분증별 분할
ID_Check v2.2.0LiveForm v2.1.0정부데이터 확인 - 한국이 기존 단일 ON/OFF 토글에서 신분증 종류별 개별 스위치(주민등록증 / 운전면허증 / 여권 / 외국인등록증)로 분할되었습니다. 고객사 정책에 맞춰 특정 신분증에 한해 진위확인을 수행할 수 있으며, 진위확인 서버의 일시적 이슈 상황에도 영향받는 신분증만 선택적으로 OFF 할 수 있습니다.- 외국인등록증 스위치는 외국인등록증 · 외국국적동포 국내거소신고증 · 영주증 3종을 통합 제어
- 2026년 4월 업데이트 — 정부데이터 확인 분할 제품 업데이트
- 인증강화 및 위조방지 — 정부데이터 확인 - 한국 대시보드 가이드
Return URL 에러 코드 전달 지원
ID_Check v2.2.0LiveForm v2.1.0Dashboard 연동 정보 > 리턴 URL의 동적 필드에 **에러 코드(errorCode)**가 신규 추가되었습니다. 사용자가 오류 페이지로 이동한 경우에도 리턴 URL 버튼을 통해 고객사 서비스로 복귀할 수 있으며, errorCode 파라미터를 통해 차단 사유를 즉시 식별할 수 있습니다.- 2026년 4월 업데이트 — Return URL 에러 코드 제품 업데이트
- 연동 정보 — 동적 필드 대시보드 가이드
- 리턴 URL 가이드 개발자 가이드
토큰 에러 코드 표준화 (TK-10000 ~ TK-10004)
LiveForm v2.1.0토큰 관련 오류 페이지에TK- 접두사 에러 코드 5종이 부여되고, 사용자 메시지가 명확하게 개선되었습니다. 오류 페이지에 코드와 정의가 함께 노출되어 트러블슈팅이 용이해집니다.TK-10000토큰 누락 /TK-10001토큰 만료 /TK-10002토큰 승인 완료 /TK-10003토큰 검토 중 /TK-10004토큰 거부- 2026년 4월 업데이트 — 토큰 에러 코드 표준화 제품 업데이트
- 에러 코드와 에러 페이지 — 토큰 에러 페이지 참조
스파이크 트래픽 시 Incomplete Submission 방지
LiveForm v2.1.0스케일 아웃 중 발생하던 Incomplete Submission 문제를 개선했습니다. eKYC 시작 시점과 Step 1 신분증 제출 전에 트래픽 부하를 사전 체크하고, 과부하 감지 시 대기 화면 노출 후 자동 재시도를 지원합니다.2026-04-07
만료된 신분증(Expired ID) 후속 처리 옵션 추가
인증강화 및 위조방지 설정에 Expired ID 옵션이 새로 추가되어, 만료 신분증 제출 시 처리 방식을 Retry 또는 Warning 중에서 선택할 수 있습니다(기본값 Retry). Warning 선택 시 Step 1·2의 Expired ID 조건을 모두 bypass하고 Warning 상태로 승인되며, Custom Policy의 Trigger에 Warning 조건이 추가되었습니다.- 2026년 4월 업데이트 — Expired ID 제품 업데이트
ID Liveness 업로드 모드 자동 Warning 전환
ID Liveness의 각 파이프라인(화면 재생 / 종이 출력물 / 초상화 교체)에서 Retry를 선택하면, 하위 체크박스 **업로드 시 Warning 적용(Apply Warning on Upload)**이 새로 노출됩니다. 체크 시 해당 파이프라인의 Retry는 사용자가 업로드 모드로 제출한 경우에 한해 Warning으로 전환됩니다. Custom Policy 목록에는userDataType: ID_card_uploaded / relatedEngine: ID Liveness Screen replay 로 노출됩니다.- 2026년 4월 업데이트 — ID Liveness 제품 업데이트
계정 비밀번호 변경 기능 추가
로그아웃 없이 대시보드 계정 메뉴에서 비밀번호를 직접 변경할 수 있습니다. OTP 미설정 시 모달에서 즉시 변경, OTP 설정 시 OTP 인증 후 변경됩니다.- 2026년 4월 업데이트 — 계정 비밀번호 변경 제품 업데이트
Submission 검색 최소 글자 수 축소 (3 → 2)
Submission 목록 검색 조건이 3글자 이상에서 2글자 이상으로 완화되어, 2자리userId를 사용하는 환경에서도 검색이 가능합니다.Passive Face Auto Capture 기능 추가
라이브폼 패시브 얼굴 촬영에 자동 캡처(Auto Capture) 기능이 추가되었습니다. 안내 문구가 화면 상단으로 이동되었고, 신규 캡처 타입face-passive-auto-capture가 추가되었으며 촬영 대기 시간이 2초 → 1초로 단축되었습니다.한국 외국인 등록증 만료일 OCR 추출 지원
한국 외국인 등록증의 만료일(expiry_date) 인식이 활성화되었습니다. OCR은 expiry_date → expiry_date0 우선순위로 값을 참조하며, 결과는 GET Submission API 응답의 data.idcard_expireDate 필드에서 확인할 수 있습니다.- 2026년 4월 업데이트 — 외국인 등록증 만료일 제품 업데이트
2026-03-30
2026-03-25
Custom Theme 기능 추가
mainColor와 innerColor 쿼리 스트링 파라미터를 사용하여 KYC 라이브폼에 브랜드 색상을 적용할 수 있습니다. CTA 버튼 및 positive 액션 UI 요소가 커스텀 색상으로 반영되어, KYC 플로우 전반에 걸쳐 브랜드 일관성을 유지할 수 있습니다.- 반드시 암호화하여 사용해야 합니다
- 값 형식:
#접두사 포함 6자리 hex (예:#AEFF00) - CTA 버튼 및 positive 액션 표시에만 적용
- Negative 표시 및 검정색 텍스트는 미적용 (향후 업데이트 예정)
- Custom Theme 제품 업데이트
- 라이브폼 커스터마이징 대시보드 가이드
- 쿼리 스트링 및 토큰 가이드 개발자 가이드
2026-03-20
Device Verification 기능 추가
KYC 인증에 접근하는 기기의 정보를 분석하여 데스크탑, 가상환경, 봇 등 비모바일 기기의 접근을 사전에 차단하는 Device Verification 기능이 추가되었습니다.- Browser check, Graphics check, Screen check 3가지 검증 수행
- 1개라도 실패 시 오류 페이지(
DE-20000)로 리다이렉트 - Device Verification 대시보드 가이드
- 인증강화 및 위조방지 옵션 설정
사전 검증 목록 메뉴 분리
기존 사용자 제출건 하위에 있던 사전 검증 목록이 독립 메뉴로 분리되었습니다. VPN & Proxy와 Device Verification 페이지로 구성됩니다.- VPN & Proxy 대시보드 가이드
- Device Verification 대시보드 가이드
커스텀 정책 거절 코드 추가
커스텀 정책 적용으로 인한 거절 시 사용되는 거절 코드applied_custom_policy가 추가되었습니다.- 거절 코드와 코멘트 참조
2026-03-19
2026-03-16
커스텀 정책 규칙 추가
KYC 프로세스에 커스텀 정책 규칙 기능이 추가되었습니다. 시각적 플로우 편집기를 통해 트리거(조건)와 액션(결과)을 연결하여 프로젝트별 맞춤형 KYC 정책을 구성할 수 있습니다.- 트리거: 사용자 필드 수정, OCR 신뢰도 임계값, 경고 발생 등 조건 설정
- 액션: ARGOS Score 상한 설정, 패널티(감점), KYC 상태 강제 변경
- 프로젝트당 최대 5개의 정책 생성 가능
- 활성/비활성 토글로 정책 적용 여부 제어
- KYC 프로세스 대시보드 가이드
PUT Image API 문서 개선
PUT Image API 문서가 개선되었습니다.multipart/form-data 형식의 요청 가이드가 추가되고, Python 코드 예시가 포함되었습니다.2026-02-15
QueryString 암호화/복호화 시뮬레이션 툴
QueryString을 암호화·복호화할 수 있는 시뮬레이션 도구가 추가되었습니다. 개발자가 암호화 로직을 쉽게 테스트하고 검증할 수 있습니다.에러 페이지 세분화
기존에 통합되어 있던 에러 페이지가 오류 유형별로 세분화되었습니다. 각 에러에 맞는 안내 메시지와 화면이 제공되어 사용자 경험이 개선됩니다.OCR 신뢰도(Confidence Score) 표시
대시보드에서 OCR 결과에 대한 신뢰도 점수가 표시됩니다. 운영자가 인식 결과의 정확도를 판단하기 쉬워졌습니다.- KYC 프로세스 대시보드 가이드
대시보드 토큰 관련 툴팁 추가
대시보드에서 토큰 관련 기능에 툴팁이 추가되어, 토큰의 의미와 사용 방법을 더 쉽게 이해할 수 있습니다.- 접근 제어 대시보드 가이드
Liveform 검색 기능 개선
Liveform에서 검색 조건 확장 및 결과 정렬이 개선되어 운영 효율이 향상되었습니다.- 사용자 제출건 대시보드 가이드
지원 신분증 타입 관리 기능
프로젝트별로 지원하는 신분증 타입을 대시보드에서 유연하게 관리할 수 있는 기능이 추가되었습니다.- KYC 프로세스 대시보드 가이드
2026-01-21
인식 실패 시 신분증 정보 안내 개선
신분증 인식 실패(recognition_fail) 발생 시, 사용자가 선택한 신분증의 정의와 제출 가능한 신분증 유형 목록이 표시되어 재시도 시 혼란이 줄어듭니다.QueryString 신분증 타입 지정 시 화면 표시 개선
라이브폼에서 QueryString으로 신분증 타입을 지정한 경우, 선택된 신분증이 화면에 표시되고 사용자가 임의로 변경할 수 없도록 고정됩니다.- 쿼리 스트링 및 토큰 개발자 가이드
2026-01-14
2025-12-30
위조방지 옵션 Warning 기능 추가
신분증 공격방지 옵션에 Warning 기능이 도입되었습니다. 임계점 미달 시 즉시 거부하지 않고 Warning을 기록한 후 후속 진행이 가능합니다. Warning 기록은 Submission에 저장되며, 대시보드 Submission 상세에 Warning 섹션이 추가되었습니다.- 인증강화 및 위조방지 대시보드 가이드
ISMS 보안 요구사항 반영
대시보드 관리자 시스템에 ISMS 보안 기준이 적용되었습니다.- 관리자 시스템 접근 로그 5년 보관
- 로그인 실패 시 계정 잠금 및 안내 메시지 개선
- 세션 타임아웃(3시간) 적용
대시보드 크레딧 사용 통계 개선
일별 크레딧 사용량이 소숫점 세 자리까지 표시되도록 수정되었습니다. 크레딧 사용량 합계 계산 및 표기 방식을 안내하는 UI 툴팁이 추가되었습니다.- 통계 대시보드 가이드
MRZ 이름 비교 옵션 신분증별 세분화
대시보드에서 여권과 기타 신분증의 MRZ 이름 비교 기준을 분리하여, 신분증 종류별로 다른 유사도 임계점을 적용할 수 있도록 개선되었습니다.- 인증강화 및 위조방지 대시보드 가이드
Active Liveness 안내문 추가
Active Liveness 옵션이 적용된 경우, 촬영 전에 사용자 안내 페이지가 표시됩니다. 화면 밝기 등 촬영 환경에 대한 가이드가 추가되어 인증 성공률이 향상됩니다.- 인증강화 및 위조방지 대시보드 가이드
대시보드 ID Liveness 명칭 통일
ID Liveness 관련 명칭과 경고 메시지 표기가 일관성 있게 정리되었습니다.- 인증강화 및 위조방지 대시보드 가이드
2025-12-24
ID Liveness 가이드 추가
ID Liveness 검증 기능에 대한 상세 가이드가 추가되었습니다. 신분증의 생생성을 검증하는 방법을 확인할 수 있습니다.- ID Liveness API 문서 참조
2025-12-19
체류만료일 조회 기능 추가
GET Submission API에expiryDateOfStayKor 필드가 추가되었습니다. 한국 법무부에 등록된 체류기간 만료일을 조회할 수 있습니다.2025-12-03
Projection API 추가
Webhook과 GET Submission 응답에서 필요한 데이터만 전달하도록 필드를 제외할 수 있는 Projection 기능이 추가되었습니다. 이를 통해 네트워크 비용 절감 및 PII 보관 부담을 줄일 수 있습니다.- Projection Overview 가이드
- POST Projection API
- GET Projection API
- DELETE Projection API
2025-11-24
Private Token에서 등록량 기반 자동 삭제 기능 추가
사전에 등록한 토큰 등록량이 임계값에 도달하면 자동으로 삭제하는 기능이 업데이트 되었습니다. 이를 통해 원활한 토큰량 관리를 지원합니다.- 사전 등록 토큰을 위한 POST Token API
- 서비스 가이드
2025-11-19
카메라 프로세스 정보 추가
GET Submission API와 GET FaceAuth API에cameraProcessInfo 필드가 추가되었습니다. 이를 통해 카메라 촬영 과정에 대한 상세 정보를 확인할 수 있습니다.2025-11-13
웹훅 토큰 기능 추가
웹훅 보안을 강화하기 위한 웹훅 토큰 기능이 추가되었습니다. 이를 통해 웹훅 요청의 무결성을 검증할 수 있습니다.PATCH/Submission 및 Search Face API 개선
PATCH/Submission API에서 더이상 data는 필수 항목이 안되도록 업데이트 되었습니다.2025-11-11
GET Submission API 업데이트
GET Submission API에updateHistory 필드가 추가되어 제출 내역의 업데이트 이력을 추적할 수 있게 되었습니다. 제출 정보 조회 기능이 전반적으로 개선되었습니다.2025-11-06
GET Projects API 추가
프로젝트 목록을 조회할 수 있는 GET Projects API가 추가되었습니다.2025-11-04
이름 필드 추가
웹훅 이벤트(approved, updated)와 PATCH/Submission, POST/Submission API에firstName과 lastName 필드가 추가되었습니다.2025-10-29
GET Submission API 확장
GET Submission API에typeOfPermit 필드 지원이 추가되었습니다.
이를 통해 허가증 유형 정보를 조회할 수 있습니다.2025-10-12
FaceAuth 애드온 기능 추가 및 개선
FaceAuth 애드온 기능이 추가되고 전반적으로 개선되었습니다. GET FaceAuth Image API의 오류가 수정되었으며, SEO를 위한 리다이렉트 설정이 변경되었습니다.2025-09-19
GET Submission API 확장
GET Submission API에detectFace 필드가 추가되었습니다.2025-09-15
GET Submission API 확장
GET Submission API에image 객체가 추가되어 이미지 정보를 더 상세하게 조회할 수 있습니다.2025-09-05
Token ID 사전 등록이 추가되었습니다.
사용할 Token ID를 API를 통해 사전 등록할 수 있으며, 삭제 되거나 ‘토큰 만료 조건 설정’ 을 통하여 만료 될 경우 Live-form 접근이 거부 됩니다. 자세한 내용은 POST Token API와 서비스 가이드를 참고하세요.2025-08-27
온고잉 모니터링 기능 추가 및 Knowledge-based에서 셀피만 찍도록 허용하는 기능 추가
- AML 온고잉 모니터링 기능이 추가되었습니다. 승인된 사용자에 대해 지속적으로 감시 목록을 모니터링할 수 있습니다.
- QueryString을 통해서 Knolwedge-based에서 skip 파라미터 사용 시, 사용자는 PII 입력 단계를 건너뛰며 셀피만으로 KYC 인증이 가능해졌습니다.
2025-08-08
2025-08-06
2025-08-01
2025-07-30
2025-07-28
2025-07-21
2025-07-14
eKYC 프로세스 재개 기능
사용자는 이제 페이지를 벗어나거나 새로고침하거나 페이지를 재시작한 후에도 Step 1과 Step 2 사이의 중단된 eKYC 프로세스를 재개할 수 있습니다. 시스템은 15분 유효성을 가진 고유한 해시 기반 식별을 사용하여 사용자 진행 상황을 추적하고 적절한 재개 지점을 결정합니다.2025-07-11
검색 기능 향상
userid로 항목을 검색할 수 있게 되었으며, 국적이 추가되었습니다. AML 검색 성능이 개선되었습니다. 개인 모드에 대한 정보 메시지가 개선되었습니다.2025-06-20
2025-06-27
POST/REVIEW API 추가
프로젝트 관리자가 pending 상태의 KYC 제출 건을 직접 검수할 수 있는 API가 추가되었습니다. 프로젝트 설정에 따라 검수자를 고객사(Client) 또는 Argos Agent로 지정할 수 있으며, Client로 설정 시 Agent는 해당 pending 건을 검수하지 않습니다.2025-06-19
2025-06-18
부분 삭제 API
관리 목적으로 부분 삭제 API가 추가되었습니다. 클라이언트는 데이터를 부분적으로 삭제할 수 있습니다. 자세한 내용은 개발자 가이드를 참조하세요.2025-06-17
2025-06-16
QueryString 파라미터 selectedIssuingCountry와 selectedIdType 추가
선택된 국가와 신분증 유형으로 KYC 프로세스를 바로 시작할 수 있습니다. URL Query에 encrypted 파라미터로 암호화하여야 설정이 가능합니다.2025-05-30
리턴 URL 기능 추가
관리자는 대시보드에서 사전에 리턴 URL 과 전달할 파라미터 항목을 선택하실 수 있습니다. 제출자는 KYC 프로세스가 완료된 뒤 “Ok” 버튼을 선택 시, 설정된 리턴 URL 과 함께 해당 Submission 의 파라미터로 리디렉션 합니다.2025-05-23
2025-05-14
Address Injection
서브미션이 승인된 건의 경우, Injection 기능을 통해 주소 정보를 추가 할 수 있습니다. 이 때 VPN 이나 proxy 와 같이 비정상적인 접근인 경우 혹은 사용자의 IP 주소와 입력한 주소 거리가 먼 경우 진행을 제한시킬 수 있습니다.2025-05-08
Custom DI 제공
관리자는 Custom DI 를 Submission 에서 제공되는 정보를 기반으로 설정할 수 있습니다. 설정된 Custom DI 로 관리자는 중복 관리를 할 수 있습니다. API 으로는 GET/SUBMISSION 을 통해 custom DI 를 조회할 수 있습니다.URL Query 암호화 옵션 allowedIdTypes, allowedDocumentFields 추가
신분증 기반의 KYC 인 ID document 프로세스가 진행되는 경우, 허용할 신분증 타입과, 허용할 필드를 설정할 수 있습니다. URL Query 에 encrypted 파라미터로 암호화하여야 설정이 가능합니다.Projection
GET/SUBMISSION 시 노출되는 개인의 민감한 정보들은 Projection 을 설정하여 노출되지 않게 설정하실 수 있습니다. Projection 목록은 GET/Projection, POST/Projection, and DELETE/Projection로 관리하실 수 있으며, Projection 적용은 사용자가 KYC 진행시 입력하는 URL 의 Query String 옵션을(Encrypted 필수) 사용하여 적용하실 수 있습니다.2025-03-27
Knowledge-based 추가
기존의 LiveForm 은 ID Document 로 정의하고, 신분증 없는 신원확인을 위한 Knowledge-based 기능을 추가하였습니다. 관련해서 매뉴얼의 암호화, Query String 관련 업데이트를 하였습니다.2024-01-23
DI 필드 추가
GET/Submission API: 중복 데이터를 식별하고 관리할 수 있는 DI(duplicated information) 필드가 추가되었습니다. 이 필드는 중복된 정보의 해시값을 제공합니다.Webhook Events: 모든 이벤트에 DI(duplicated information) 필드가 추가되어, 중복된 정보에 대한 해시값을 반환합니다.
2024-12-16
개발 문서가 새로워졌습니다 🚀
더 쉽고 직관적인 개발 경험을 위해 개발 문서를 전면 개편했습니다. 처음 사용하는 사용자부터 숙련된 개발자까지, 누구나 빠르게 이해하고 활용할 수 있도록 준비했어요.이번 개편에서 달라진 점
1. 문서 구조를 새롭게 정비했습니다
더욱 체계적이고 직관적인 구조로 문서를 재구성했습니다. 필요한 정보를 빠르게 찾아볼 수 있도록 목차와 섹션을 깔끔하게 정리했어요.2. API 레퍼런스를 강화했습니다
이제 모든 엔드포인트에 상세한 설명과 함께 실제 예제 코드를 제공합니다. 매개변수와 반환값도 한눈에 파악할 수 있어 개발 효율이 높아집니다.3. 튜토리얼 섹션이 추가되었습니다
처음 사용하는 사용자도 쉽게 따라할 수 있도록 단계별 가이드를 제공합니다. 기초부터 시작해 문서를 활용하는 방법을 차근차근 배워보세요.4. 검색 기능을 업그레이드했습니다
원하는 정보를 더 빠르게 찾을 수 있도록 검색 알고리즘을 개선했습니다. 키워드 자동 완성과 관련 문서 추천 기능도 추가되었어요.피드백을 기다립니다
문서가 유용하셨나요? 각 섹션 하단에서 Yes 또는 No 버튼을 눌러 의견을 알려주세요. 추가로 개선할 점이나 의견이 있다면 CS 팀을 통해 언제든지 전달해주시면 감사하겠습니다.더 나은 개발 환경을 위해 항상 고민하고 개선하겠습니다. 앞으로도 여러분의 목소리에 귀 기울이는 ARGOS Identity 팀이 되겠습니다. 감사합니다. ARGOS Identity 드림이전 버전의 개발 문서를 보시려면 여기를 클릭하세요