메인 콘텐츠로 건너뛰기
ARGOS Identity ID Check 서비스를 연동하고 운영하시는 과정에서 자주 문의 주시는 내용을 정리했습니다. 각 질문을 클릭하시면 상세 답변이 펼쳐집니다. 원하시는 답변이 없다면 고객 지원으로 문의해 주세요.

​
인증 프로세스 및 Flow

프로젝트 단위로 독립된 인증 Flow 를 제공하며, 프로젝트는 여러 개 생성할 수 있습니다. 프로젝트별로 다음 항목을 개별 설정하실 수 있습니다.
  • 지원 국가 및 신분증 유형 (KYC Process > 지원 ID Type 관리)
  • 신분증·셀피·Liveness 등 인증 단계 정책 (정책 및 인증 > 인증강화 및 위조방지)
  • 추가 정보 수집 (프로젝트 설정 > 추가 정보)
  • ARGOS Score 기준값 및 자동 처리 정책 (KYC Process)
  • Webhook · Return URL (프로젝트 설정 > 연동 정보)
  • 결과 페이지 커스터마이징 (사용자 경험 > 라이브폼 커스터마이징)
각 서비스에서 해당 프로젝트의 Liveform URL 을 호출하시면 서비스마다 다른 인증 플로우를 노출하실 수 있습니다. 추가 프로젝트 생성이 필요하시면 영업팀으로 요청해 주세요.
정책 및 인증 > KYC Process > 나이제한 에서 최소 연령을 입력하시면, 신분증에 표기된 생년월일 기준으로 설정 연령 미만 사용자의 제출이 자동 거절됩니다. 거절 코드는 under_ageLimit 이며, 자세한 코드 목록은 거절 코드 에서 확인하실 수 있습니다.셀피 기반 연령 검증이 필요하신 경우 인증강화 및 위조방지 > 얼굴 기반 나이 검증 을 함께 활성화해 주세요.
가능합니다. 다음 방식 중 프로젝트 상황에 맞게 선택하실 수 있습니다.
  • 프로젝트 분리: 국가별 별도 프로젝트로 분리 운영
  • KYC Process > 지원 ID Type 관리: 한 프로젝트 내에서 국가별 허용 신분증을 CSV 로 설정
  • 블랙리스트 국가 (발급국가): 특정 국가 발급 신분증 제출 차단
  • Liveform 쿼리스트링 (allowedCountries, blacklistCountries) 으로 제출 시점에 국가 제한 적용
국가별 지원 신분증 유형은 Supported ID Types 에서 확인하실 수 있습니다.
네. 인증강화 및 위조방지 에서 신분증 위조 방지(MRZ, PDF417 바코드, ID Liveness, 스트리밍 촬영), 셀피 프로세스·얼굴 중복 확인·셀피 라이브니스, 3rd party 데이터 검증(1원 계좌·정부 데이터·주소지 증명 등) 을 프로젝트 정책에 맞게 조합할 수 있습니다. 각 옵션에 대한 결과는 GET Submission의 submissionId 조회를 통해 상세하게 확인 가능합니다.

​
운영

별도의 Sandbox 환경은 제공되지 않으며, 모든 제출 건은 해당 프로젝트의 크레딧으로 차감됩니다. 대신 운영 프로젝트와 분리된 별도 프로젝트(개발·QA 용) 를 생성하여 사용하실 수 있으며, 각 프로젝트는 API Key · 설정 · 크레딧이 모두 독립적으로 운영됩니다.추가 프로젝트 생성이 필요하시면 영업팀 으로 요청해 주세요.
네. 크레딧은 제출이 생성되는 시점 에 차감되므로, 이후 거절되거나 삭제된 건도 이미 차감된 상태로 유지됩니다. 시스템 오류로 정상 처리되지 못한 건은 지원팀으로 문의 주시면 확인 후 조치해 드립니다.

​
어뷰징 및 보안

정책 및 인증 > 인증강화 및 위조방지 페이지에서 다음 기능들을 조합하시면 효과적으로 대응하실 수 있습니다.
  • Proxy & VPN 감지: 의심 IP 대역에서 오는 제출 탐지
  • Device Verification: 모바일이 아닌 환경 감지
  • 얼굴 중복 확인 (Face Duplication): 동일 얼굴을 이용한 중복 계정 탐지
  • 신분증 위조 방지: MRZ 검사, PDF417 바코드 검사, ID Liveness, 스트리밍 촬영
  • 셀피 라이브니스: Passive / Active Liveness 로 사진·딥페이크 탐지
자세한 권장 조합은 인증강화 및 위조방지 가이드 를 참고해 주세요.
ARGOS 는 DI (duplicated_information) 를 이름 · 생년월일 · 성별 · 국적 네 가지 값의 조합으로 생성하여 동일 인물의 중복 제출을 자동 식별합니다. 네 값이 모두 제공된 경우에만 DI 가 생성됩니다. 기본 DI 외에 Custom DI 를 활용하시면 프로젝트 상황에 맞는 추가 필드 조합으로도 동일 인물의 중복 제출을 식별하실 수 있습니다.
  • GET/Submission 응답의 duplicated_information, duplicated_users, duplicated_selfie_users 필드로 중복 여부 확인
  • 중복 처리 정책은 정책 및 인증 > 인증 데이터 에서 조정
  • 얼굴 중복 확인 (Face Duplication) 옵션을 함께 적용하시면 신분증을 바꿔 가며 시도하는 케이스도 탐지됩니다
기본값은 차단이 아닙니다. 정책 및 인증 > 인증강화 및 위조방지 > Proxy & VPN 감지 옵션을 활성화해 주세요. 감지된 유형(Proxy, VPN, Commercial VPN, Hosting Provider)의 종합 위험 점수에 따라 차단됩니다. 탐지 결과는 사전 검증 목록 > VPN & Proxy 페이지에서 조회 가능합니다.
API Key 는 프로젝트 설정 > 연동 정보 에서 확인하실 수 있습니다. 유출이 의심되는 경우 담당 영업팀 또는 고객 지원 을 통해 재발급·폐기를 요청해 주세요.보안 강화를 위해 다음 설정을 병행하시는 것을 권장합니다.
  • 시스템 운영 > IP 화이트리스트: API 호출을 허용할 IP 를 등록 (CIDR 지원)
  • 보안 설정 > 접근 제어: 프라이빗 모드 활성화 + Live-form Token ID 사전 등록
  • 보안 설정 > 데이터 보호: 안전한 데이터 전송 옵션으로 API · 웹훅 통신 암호화

​
자동화 및 수동 검수

정책 및 인증 > KYC Process 에서 다음을 설정하시면 됩니다.
  1. 아르고스 점수 기준값 을 업종·정책에 맞게 선택합니다 (보수적 70 / 표준 50 / 개방적 40)
  2. 자동 처리만 진행 옵션을 활성화합니다 — Pending(수동 검수 필요) 건은 자동으로 거절 처리됩니다
  3. 필요 시 커스텀 정책 규칙 으로 OCR 신뢰도 · 필드 수정 · 경고 발생 조건에 따라 ARGOS Score 상한·감점·상태 재설정을 적용합니다
완전 자동화는 오심 리스크가 동반되므로 업종 규제(금융·게이밍·통신 등) 와 내부 정책을 함께 검토하신 뒤 적용하시길 권장드립니다.
사용자 제출건 페이지에서 제출 목록과 상세 정보를 조회하고, Pending 상태 건은 상세 화면에서 KYC Status 를 직접 변경하실 수 있습니다. 관리자 활동과 제출건 삭제 이력은 이벤트 로그 에 남습니다.검수 주체는 프로젝트 설정 > 시스템 운영 > 검수자 설정 에서 ARGOS 전문 검수자 와 클라이언트 API 중 선택하실 수 있습니다.
네. POST https://rest-api.argosidentity.com/v3/submission/review 엔드포인트로 Pending 상태 제출 건을 approved 또는 rejected 로 변경하실 수 있습니다.
  • 요청 본문에 submissionId, status, admin (프로젝트 관리자로 등록된 계정) 이 필수입니다
  • status=rejected 인 경우 rejectComment 가 필수입니다
  • 이미 승인·거절된 제출 건은 PATCH API 로 수정하실 수 있습니다. 완료된 건의 상태를 되돌려야 하는 경우 PATCH API 를 호출하시거나, 대시보드의 사용자 제출건 > 상세보기 에서 직접 변경하실 수 있으며, 어려우신 경우 고객 지원으로 문의해 주세요
자세한 요청 형식은 REVIEW/Submission 문서를 참고해 주세요.

​
데이터 및 개인정보 보호

두 가지 API 를 제공합니다.
  • DELETE /v3/submission: 제출 건의 모든 데이터 완전 삭제 (복원 불가)
  • DELETE /v3/submission/partial: fields 파라미터로 선택한 데이터만 삭제
GDPR · CCPA 등 사용자 요청 대응 시에도 동일한 API 를 활용하실 수 있으며, 삭제 내역은 이벤트 로그 에 기록됩니다. 삭제된 제출 건도 과금 대상에는 포함된 점에 유의해 주세요.
Delete 는 제출 건 전체를 삭제합니다. Partial Delete 는 fields 파라미터에 지정한 항목만 삭제합니다. 지원되는 fields 값은 다음과 같습니다.
  • id_image, selfie_image
  • data, OCR_raw, ocr, review
  • applicant_id, email, userid
  • duplicated_information, custom_duplicated_information
  • additional_list
예를 들어 민감 이미지·개인정보만 지우고 duplicated_information 은 남기면 중복 가입 방지용 식별자는 유지한 채 주요 데이터만 제거할 수 있습니다.Partial Delete 를 중복 체크 대상 컴포넌트에 적용하면 이후 동일 데이터가 들어와도 해당 제출 건에 대해서는 중복 체크가 적용되지 않으니 주의해 주세요.
이미지 조회는 GET /v3/image API 로 가능하며, submissionId 와 type (idImage, idBackImage, selfieImage) 을 지정합니다. 한 번의 호출로 한 개의 이미지가 직접 반환됩니다.이미 생성된 제출 건에 이미지를 추가·업데이트하려면 PUT /v3/submission/image 로 Base64 인코딩된 이미지를 multipart/form-data 로 업로드하실 수 있습니다. 암호화 옵션은 Encrypt and Decrypt Data 문서를 참고해 주세요.
보안 설정 > 데이터 보호 에서 두 가지 옵션을 제공합니다.
  • 라이브폼 암호화: Liveform URL 쿼리스트링을 ECB / GCM 방식으로 암호화합니다 (API Key 또는 전용 secretKey 사용). 전체 파라미터를 encrypted 하나로 묶는 암호화 전용 모드 도 제공됩니다.
  • 안전한 데이터 전송: 활성화 시 API 요청(AES-256-ECB) · 응답 · 웹훅(AES-256-CBC) 이 모두 암호화되어 전송됩니다.
자세한 사용법과 코드 예시는 Encrypt and Decrypt Data 문서를 참고해 주세요.

​
기술 통합 및 연동

ARGOS 는 개별 Webhook 전송 이벤트를 대시보드에 영구 저장하지 않습니다. 다음 순서로 점검해 주세요.
  1. 프로젝트 설정 > 연동 정보 에서 Webhook URL 이 정확히 등록되어 있는지 확인합니다 (HTTPS 필수).
  2. 방화벽 · 보안 그룹의 허용 IP 에 ARGOS 발신 IP 52.78.194.237 가 추가되어 있는지 확인합니다.
  3. 수신 서버가 2xx 코드로 응답했는지 자체 로그에서 확인합니다.
  4. 암호화 옵션을 사용 중이라면 AES-256-CBC 복호화 로직을 점검합니다.
  5. 연동 정보 > 알림 사용자 관리 에 이름과 이메일을 등록하시면, 다음 날 아침에 전날(UTC 00:00–23:59) 발송된 웹훅 요약 리포트를 이메일로 받아보실 수 있습니다.
Webhook URL 변경 이력은 저장되지 않으므로 URL 을 수정하실 때는 별도로 관리해 주세요.
webhook_trigger 값으로 다음 이벤트가 제공됩니다.
Trigger설명
created새 Submission 생성
retryKYC 진행 중 재시도 발생
submit보류(pending) 상태 변경
approved승인
rejected거절
updatedSubmission 정보 업데이트
deleteSubmission 삭제
token_expiredToken ID 만료
injectionData Injection 진행
amlAML 검색 결과 수신
aml_monitorAML Ongoing Monitoring 결과 수신
각 이벤트의 payload 는 Webhook 이벤트 문서에서 확인하실 수 있습니다.
모든 ID Check API 엔드포인트에 초당 5,000 요청 (QPS) · 일일 100,000 요청 (QPD) 의 제한이 적용됩니다. 초과 시 요청이 제한되며, 일정 시간 뒤 정상 호출이 재개됩니다. 상시 초과가 발생한다면 호출 로직을 점검하시거나 고객 지원 으로 한도 상향을 문의해 주세요. 자세한 정책은 Rate Limits 문서를 참고해 주세요.
프로젝트 설정 > 연동 정보 > 리턴 URL 에서 URL 을 등록하고, 동적 필드에서 전달할 파라미터를 선택합니다. 지원 파라미터는 다음과 같습니다.
  • kycStatus — 값: approved, pending, rejected
  • userid, email, submissionId
  • cf1, cf2, cf3
암호화 옵션을 활성화하시면 선택한 파라미터가 encrypted 하나로 묶여 AES-256-ECB 로 전달됩니다. 결과 페이지를 건너뛰고 리턴 URL 로 바로 리디렉션하려면 결과 페이지 스킵 옵션을 함께 활성화해 주세요. 자세한 사용법은 Return URL Guide 를 참고해 주세요.
iOS Safari 와 In-App Browser 의 카메라 정책 관련 안내를 제공하고 있습니다. 대부분의 이슈는 iOS Block Page 와 Camera Permission 문서로 해결하실 수 있습니다.
사용자 경험 > 라이브폼 커스터마이징 에서 결과 상태(Approved · Rejected · Pending) 별 · 언어별로 결과 페이지를 구성하실 수 있습니다. 각 페이지에 이미지 업로드, 메인 텍스트(최대 125자), 서브 텍스트(최대 100자) 를 지정하실 수 있습니다.결과 페이지 자체를 건너뛰고 고객사 페이지로 바로 리디렉션하려면 연동 정보 > 결과 페이지 스킵 옵션을 활성화하고 Return URL 의 동적 필드에서 원하는 파라미터를 선택해 주세요.
프로젝트 관리자 추가는 프로젝트 설정 > 시스템 운영 > 관리자 설정 에서 이메일과 이름으로 초대하실 수 있습니다 (초대 유효기간 7일). 이미 대시보드에 가입된 사용자는 즉시 추가되고, 미가입 사용자는 초대 메일이 발송됩니다. 현재는 프로젝트 접근 권한의 추가/제거만 지원되며, 세분화된 권한 관리 기능은 추후 제공될 예정입니다.개별 관리자 계정의 OTP (2단계 인증) 활성화는 대시보드 좌측 하단 프로필 메뉴의 OTP 설정 에서 진행하실 수 있습니다.
AML 스크리닝은 eKYC 결과가 Approved 된 시점에 자동으로 수행 됩니다. 이미 생성된 제출 건에 대해 수동으로 실행하려면 POST /v3/submission/aml 엔드포인트를 호출하시면 됩니다.
  • Webhook: webhook_trigger: aml 이벤트로 결과 수신
  • API: GET /v3/report/aml 로 상세 PDF 리포트 다운로드 (resourceId 는 AML 결과가 Red Flag 일 때만 생성)
지속적인 모니터링이 필요하시면 AML Ongoing Monitoring 기능도 함께 활용해 주세요.

​
원하시는 답변이 없으신가요?

고객 지원 요청

지원 포털로 티켓을 남겨 주시면 담당자가 빠르게 답변드립니다.

영업 문의

요구사항에 맞는 플랜과 기술 상담이 필요하시다면 영업팀에 문의해 주세요.