> ## 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.

# Q&A

> ARGOS Identity ID Check 서비스를 운영하시면서 자주 문의 주시는 질문과 답변을 모았습니다.

ARGOS Identity ID Check 서비스를 연동하고 운영하시는 과정에서 자주 문의 주시는 내용을 정리했습니다. 각 질문을 클릭하시면 상세 답변이 펼쳐집니다. 원하시는 답변이 없다면 [고객 지원](https://support.argosidentity.com/hc/ko/requests/new)으로 문의해 주세요.

## 인증 프로세스 및 Flow

<AccordionGroup>
  <Accordion title="Q. 서비스별로 다른 인증 Flow 를 제공하고 싶어요." icon="layer-group">
    프로젝트 단위로 독립된 인증 Flow 를 제공하며, 프로젝트는 여러 개 생성할 수 있습니다. 프로젝트별로 다음 항목을 개별 설정하실 수 있습니다.

    * 지원 국가 및 신분증 유형 (**KYC Process > 지원 ID Type 관리**)
    * 신분증·셀피·Liveness 등 인증 단계 정책 (**정책 및 인증 > 인증강화 및 위조방지**)
    * 추가 정보 수집 (**프로젝트 설정 > 추가 정보**)
    * ARGOS Score 기준값 및 자동 처리 정책 (**KYC Process**)
    * Webhook · Return URL (**프로젝트 설정 > 연동 정보**)
    * 결과 페이지 커스터마이징 (**사용자 경험 > 라이브폼 커스터마이징**)

    각 서비스에서 해당 프로젝트의 Liveform URL 을 호출하시면 서비스마다 다른 인증 플로우를 노출하실 수 있습니다. 추가 프로젝트 생성이 필요하시면 [영업팀](https://tally.so/r/wg946l)으로 요청해 주세요.
  </Accordion>

  <Accordion title="Q. 연령 제한은 어떻게 설정하나요?" icon="child">
    **정책 및 인증 > KYC Process > 나이제한** 에서 최소 연령을 입력하시면, 신분증에 표기된 생년월일 기준으로 설정 연령 미만 사용자의 제출이 자동 거절됩니다. 거절 코드는 `under_ageLimit` 이며, 자세한 코드 목록은 [거절 코드](/ko/idcheck/reference_tables/reject-codes-and-comments) 에서 확인하실 수 있습니다.

    셀피 기반 연령 검증이 필요하신 경우 **인증강화 및 위조방지 > 얼굴 기반 나이 검증** 을 함께 활성화해 주세요.
  </Accordion>

  <Accordion title="Q. 국가별로 다른 신분증·신원정보 정책을 적용할 수 있나요?" icon="flag">
    가능합니다. 다음 방식 중 프로젝트 상황에 맞게 선택하실 수 있습니다.

    * **프로젝트 분리**: 국가별 별도 프로젝트로 분리 운영
    * **KYC Process > 지원 ID Type 관리**: 한 프로젝트 내에서 국가별 허용 신분증을 CSV 로 설정
    * **블랙리스트 국가 (발급국가)**: 특정 국가 발급 신분증 제출 차단
    * **Liveform 쿼리스트링** (`allowedCountries`, `blacklistCountries`) 으로 제출 시점에 국가 제한 적용

    국가별 지원 신분증 유형은 [Supported ID Types](/ko/idcheck/reference_tables/supported-id-types-alpha-3-country-codes) 에서 확인하실 수 있습니다.
  </Accordion>

  <Accordion title="Q. 한 Liveform 에서 여러 인증 단계를 순차적으로 진행할 수 있나요?" icon="list-check">
    네. **인증강화 및 위조방지** 에서 신분증 위조 방지(MRZ, PDF417 바코드, ID Liveness, 스트리밍 촬영), 셀피 프로세스·얼굴 중복 확인·셀피 라이브니스, 3rd party 데이터 검증(1원 계좌·정부 데이터·주소지 증명 등) 을 프로젝트 정책에 맞게 조합할 수 있습니다. 각 옵션에 대한 결과는 **GET Submission의 submissionId 조회**를 통해 상세하게 확인 가능합니다.
  </Accordion>
</AccordionGroup>

## 운영

<AccordionGroup>
  <Accordion title="Q. 개발·QA 용 환경을 운영과 분리해서 쓸 수 있나요?" icon="flask">
    별도의 Sandbox 환경은 제공되지 않으며, 모든 제출 건은 해당 프로젝트의 크레딧으로 차감됩니다. 대신 운영 프로젝트와 분리된 **별도 프로젝트(개발·QA 용)** 를 생성하여 사용하실 수 있으며, 각 프로젝트는 API Key · 설정 · 크레딧이 모두 독립적으로 운영됩니다.

    추가 프로젝트 생성이 필요하시면 [영업팀](https://tally.so/r/wg946l) 으로 요청해 주세요.
  </Accordion>

  <Accordion title="Q. 삭제되거나 거절된 제출 건도 크레딧이 차감되나요?" icon="trash-arrow-up">
    네. 크레딧은 제출이 **생성되는 시점** 에 차감되므로, 이후 거절되거나 삭제된 건도 이미 차감된 상태로 유지됩니다. 시스템 오류로 정상 처리되지 못한 건은 지원팀으로 문의 주시면 확인 후 조치해 드립니다.
  </Accordion>
</AccordionGroup>

## 어뷰징 및 보안

<AccordionGroup>
  <Accordion title="Q. 어뷰징·위·변조 시도를 종합적으로 막으려면 어떻게 해야 하나요?" icon="shield-halved">
    **정책 및 인증 > 인증강화 및 위조방지** 페이지에서 다음 기능들을 조합하시면 효과적으로 대응하실 수 있습니다.

    * **Proxy & VPN 감지**: 의심 IP 대역에서 오는 제출 탐지
    * **Device Verification**: 모바일이 아닌 환경 감지
    * **얼굴 중복 확인 (Face Duplication)**: 동일 얼굴을 이용한 중복 계정 탐지
    * **신분증 위조 방지**: MRZ 검사, PDF417 바코드 검사, ID Liveness, 스트리밍 촬영
    * **셀피 라이브니스**: Passive / Active Liveness 로 사진·딥페이크 탐지

    자세한 권장 조합은 [인증강화 및 위조방지 가이드](/dashboard/ko/project-management/policy-and-authentication/anti-fraud-and-forgery-prevention) 를 참고해 주세요.
  </Accordion>

  <Accordion title="Q. 동일 사용자의 중복 제출을 막으려면?" icon="user-slash">
    ARGOS 는 **DI (duplicated\_information)** 를 **이름 · 생년월일 · 성별 · 국적** 네 가지 값의 조합으로 생성하여 동일 인물의 중복 제출을 자동 식별합니다. 네 값이 모두 제공된 경우에만 DI 가 생성됩니다. 기본 DI 외에 **Custom DI** 를 활용하시면 프로젝트 상황에 맞는 추가 필드 조합으로도 동일 인물의 중복 제출을 식별하실 수 있습니다.

    * GET/Submission 응답의 `duplicated_information`, `duplicated_users`, `duplicated_selfie_users` 필드로 중복 여부 확인
    * 중복 처리 정책은 **정책 및 인증 > 인증 데이터** 에서 조정
    * **얼굴 중복 확인 (Face Duplication)** 옵션을 함께 적용하시면 신분증을 바꿔 가며 시도하는 케이스도 탐지됩니다
  </Accordion>

  <Accordion title="Q. VPN 이나 Proxy 사용자는 자동으로 차단되나요?" icon="globe">
    기본값은 차단이 아닙니다. **정책 및 인증 > 인증강화 및 위조방지 > Proxy & VPN 감지** 옵션을 활성화해 주세요. 감지된 유형(Proxy, VPN, Commercial VPN, Hosting Provider)의 종합 위험 점수에 따라 차단됩니다. 탐지 결과는 **사전 검증 목록 > VPN & Proxy** 페이지에서 조회 가능합니다.
  </Accordion>

  <Accordion title="Q. API Key 가 외부에 노출된 것 같아요." icon="key">
    API Key 는 **프로젝트 설정 > 연동 정보** 에서 확인하실 수 있습니다. 유출이 의심되는 경우 담당 영업팀 또는 [고객 지원](https://support.argosidentity.com/hc/ko/requests/new) 을 통해 재발급·폐기를 요청해 주세요.

    보안 강화를 위해 다음 설정을 병행하시는 것을 권장합니다.

    * **시스템 운영 > IP 화이트리스트**: API 호출을 허용할 IP 를 등록 (CIDR 지원)
    * **보안 설정 > 접근 제어**: 프라이빗 모드 활성화 + Live-form Token ID 사전 등록
    * **보안 설정 > 데이터 보호**: 안전한 데이터 전송 옵션으로 API · 웹훅 통신 암호화
  </Accordion>
</AccordionGroup>

## 자동화 및 수동 검수

<AccordionGroup>
  <Accordion title="Q. 수동 검수 없이 완전 자동 심사로 운영하려면?" icon="robot">
    **정책 및 인증 > KYC Process** 에서 다음을 설정하시면 됩니다.

    1. **아르고스 점수 기준값** 을 업종·정책에 맞게 선택합니다 (보수적 70 / 표준 50 / 개방적 40)
    2. **자동 처리만 진행** 옵션을 활성화합니다 — Pending(수동 검수 필요) 건은 자동으로 거절 처리됩니다
    3. 필요 시 **커스텀 정책 규칙** 으로 OCR 신뢰도 · 필드 수정 · 경고 발생 조건에 따라 ARGOS Score 상한·감점·상태 재설정을 적용합니다

    완전 자동화는 오심 리스크가 동반되므로 업종 규제(금융·게이밍·통신 등) 와 내부 정책을 함께 검토하신 뒤 적용하시길 권장드립니다.
  </Accordion>

  <Accordion title="Q. 제출 건은 어디서 검토하고 결과는 어떻게 변경하나요?" icon="magnifying-glass">
    **사용자 제출건** 페이지에서 제출 목록과 상세 정보를 조회하고, Pending 상태 건은 상세 화면에서 KYC Status 를 직접 변경하실 수 있습니다. 관리자 활동과 제출건 삭제 이력은 **이벤트 로그** 에 남습니다.

    검수 주체는 **프로젝트 설정 > 시스템 운영 > 검수자 설정** 에서 `ARGOS 전문 검수자` 와 `클라이언트 API` 중 선택하실 수 있습니다.
  </Accordion>

  <Accordion title="Q. Pending 상태 제출 건을 API 로 심사할 수 있나요?" icon="rotate-right">
    네. `POST https://rest-api.argosidentity.com/v3/submission/review` 엔드포인트로 Pending 상태 제출 건을 `approved` 또는 `rejected` 로 변경하실 수 있습니다.

    * 요청 본문에 `submissionId`, `status`, `admin` (프로젝트 관리자로 등록된 계정) 이 필수입니다
    * `status=rejected` 인 경우 `rejectComment` 가 필수입니다
    * **이미 승인·거절된 제출 건은 PATCH API 로 수정하실 수 있습니다.** 완료된 건의 상태를 되돌려야 하는 경우 PATCH API 를 호출하시거나, 대시보드의 **사용자 제출건 > 상세보기** 에서 직접 변경하실 수 있으며, 어려우신 경우 고객 지원으로 문의해 주세요

    자세한 요청 형식은 [REVIEW/Submission](/ko/idcheck/api-reference/api-reference-guide/post-client-review) 문서를 참고해 주세요.
  </Accordion>
</AccordionGroup>

## 데이터 및 개인정보 보호

<AccordionGroup>
  <Accordion title="Q. 사용자 데이터 삭제 요청은 어떻게 처리하나요?" icon="database">
    두 가지 API 를 제공합니다.

    * **`DELETE /v3/submission`**: 제출 건의 모든 데이터 완전 삭제 (복원 불가)
    * **`DELETE /v3/submission/partial`**: `fields` 파라미터로 선택한 데이터만 삭제

    GDPR · CCPA 등 사용자 요청 대응 시에도 동일한 API 를 활용하실 수 있으며, 삭제 내역은 **이벤트 로그** 에 기록됩니다. 삭제된 제출 건도 과금 대상에는 포함된 점에 유의해 주세요.
  </Accordion>

  <Accordion title="Q. Partial Delete 와 Delete 의 차이는 무엇인가요?" icon="scissors">
    **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 를 중복 체크 대상 컴포넌트에 적용하면 이후 동일 데이터가 들어와도 해당 제출 건에 대해서는 중복 체크가 적용되지 않으니 주의해 주세요.
  </Accordion>

  <Accordion title="Q. 수집한 이미지는 어떻게 보관되고 조회할 수 있나요?" icon="image">
    이미지 조회는 **`GET /v3/image`** API 로 가능하며, `submissionId` 와 `type` (`idImage`, `idBackImage`, `selfieImage`) 을 지정합니다. 한 번의 호출로 한 개의 이미지가 직접 반환됩니다.

    이미 생성된 제출 건에 이미지를 추가·업데이트하려면 **`PUT /v3/submission/image`** 로 Base64 인코딩된 이미지를 `multipart/form-data` 로 업로드하실 수 있습니다. 암호화 옵션은 [Encrypt and Decrypt Data](/ko/idcheck/getting-started/encrypt-and-decrypt-data/overview) 문서를 참고해 주세요.
  </Accordion>

  <Accordion title="Q. 데이터 전송 구간을 암호화하려면?" icon="user-shield">
    **보안 설정 > 데이터 보호** 에서 두 가지 옵션을 제공합니다.

    * **라이브폼 암호화**: Liveform URL 쿼리스트링을 ECB / GCM 방식으로 암호화합니다 (API Key 또는 전용 secretKey 사용). 전체 파라미터를 `encrypted` 하나로 묶는 **암호화 전용 모드** 도 제공됩니다.
    * **안전한 데이터 전송**: 활성화 시 API 요청(AES-256-ECB) · 응답 · 웹훅(AES-256-CBC) 이 모두 암호화되어 전송됩니다.

    자세한 사용법과 코드 예시는 [Encrypt and Decrypt Data](/ko/idcheck/getting-started/encrypt-and-decrypt-data/overview) 문서를 참고해 주세요.
  </Accordion>
</AccordionGroup>

## 기술 통합 및 연동

<AccordionGroup>
  <Accordion title="Q. Webhook 이 수신되지 않을 때 어떻게 점검하나요?" icon="plug">
    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 을 수정하실 때는 별도로 관리해 주세요.
  </Accordion>

  <Accordion title="Q. Webhook 이벤트 종류는 어떤 것이 있나요?" icon="webhook">
    `webhook_trigger` 값으로 다음 이벤트가 제공됩니다.

    | Trigger         | 설명                           |
    | --------------- | ---------------------------- |
    | `created`       | 새 Submission 생성              |
    | `retry`         | KYC 진행 중 재시도 발생              |
    | `submit`        | 보류(pending) 상태 변경            |
    | `approved`      | 승인                           |
    | `rejected`      | 거절                           |
    | `updated`       | Submission 정보 업데이트           |
    | `delete`        | Submission 삭제                |
    | `token_expired` | Token ID 만료                  |
    | `injection`     | Data Injection 진행            |
    | `aml`           | AML 검색 결과 수신                 |
    | `aml_monitor`   | AML Ongoing Monitoring 결과 수신 |

    각 이벤트의 payload 는 [Webhook 이벤트](/ko/idcheck/webhooks/overview) 문서에서 확인하실 수 있습니다.
  </Accordion>

  <Accordion title="Q. API Rate Limit 을 초과하면 어떻게 되나요?" icon="gauge-high">
    모든 ID Check API 엔드포인트에 **초당 5,000 요청 (QPS)** · **일일 100,000 요청 (QPD)** 의 제한이 적용됩니다. 초과 시 요청이 제한되며, 일정 시간 뒤 정상 호출이 재개됩니다. 상시 초과가 발생한다면 호출 로직을 점검하시거나 [고객 지원](https://support.argosidentity.com/hc/ko/requests/new) 으로 한도 상향을 문의해 주세요. 자세한 정책은 [Rate Limits](/ko/idcheck/api-reference/api-reference-guide/rate-limits) 문서를 참고해 주세요.
  </Accordion>

  <Accordion title="Q. Return URL 설정 방법과 전달되는 값이 궁금합니다." icon="link">
    **프로젝트 설정 > 연동 정보 > 리턴 URL** 에서 URL 을 등록하고, 동적 필드에서 전달할 파라미터를 선택합니다. 지원 파라미터는 다음과 같습니다.

    * `kycStatus` — 값: `approved`, `pending`, `rejected`
    * `userid`, `email`, `submissionId`
    * `cf1`, `cf2`, `cf3`

    암호화 옵션을 활성화하시면 선택한 파라미터가 `encrypted` 하나로 묶여 AES-256-ECB 로 전달됩니다. 결과 페이지를 건너뛰고 리턴 URL 로 바로 리디렉션하려면 **결과 페이지 스킵** 옵션을 함께 활성화해 주세요. 자세한 사용법은 [Return URL Guide](/ko/idcheck/getting-started/liveform-url/return-url-guide) 를 참고해 주세요.
  </Accordion>

  <Accordion title="Q. iOS 에서 카메라가 열리지 않거나 권한이 거부됩니다." icon="mobile-screen">
    iOS Safari 와 In-App Browser 의 카메라 정책 관련 안내를 제공하고 있습니다. 대부분의 이슈는 [iOS Block Page](/ko/idcheck/getting-started/ios_block_page) 와 [Camera Permission](/ko/idcheck/getting-started/camera-permission) 문서로 해결하실 수 있습니다.
  </Accordion>

  <Accordion title="Q. Liveform 결과 페이지를 커스터마이징할 수 있나요?" icon="palette">
    **사용자 경험 > 라이브폼 커스터마이징** 에서 **결과 상태(Approved · Rejected · Pending)** 별 · 언어별로 결과 페이지를 구성하실 수 있습니다. 각 페이지에 이미지 업로드, 메인 텍스트(최대 125자), 서브 텍스트(최대 100자) 를 지정하실 수 있습니다.

    결과 페이지 자체를 건너뛰고 고객사 페이지로 바로 리디렉션하려면 **연동 정보 > 결과 페이지 스킵** 옵션을 활성화하고 Return URL 의 동적 필드에서 원하는 파라미터를 선택해 주세요.
  </Accordion>

  <Accordion title="Q. 여러 관리자 / 검수자 계정을 추가할 수 있나요?" icon="users">
    프로젝트 관리자 추가는 **프로젝트 설정 > 시스템 운영 > 관리자 설정** 에서 이메일과 이름으로 초대하실 수 있습니다 (초대 유효기간 7일). 이미 대시보드에 가입된 사용자는 즉시 추가되고, 미가입 사용자는 초대 메일이 발송됩니다. 현재는 프로젝트 접근 권한의 추가/제거만 지원되며, 세분화된 권한 관리 기능은 추후 제공될 예정입니다.

    개별 관리자 계정의 **OTP (2단계 인증)** 활성화는 대시보드 좌측 하단 프로필 메뉴의 **OTP 설정** 에서 진행하실 수 있습니다.
  </Accordion>

  <Accordion title="Q. AML 스크리닝은 언제 실행되고 결과는 어떻게 받나요?" icon="scale-balanced">
    AML 스크리닝은 eKYC 결과가 **Approved 된 시점에 자동으로 수행** 됩니다. 이미 생성된 제출 건에 대해 수동으로 실행하려면 `POST /v3/submission/aml` 엔드포인트를 호출하시면 됩니다.

    * **Webhook**: `webhook_trigger: aml` 이벤트로 결과 수신
    * **API**: `GET /v3/report/aml` 로 상세 PDF 리포트 다운로드 (`resourceId` 는 AML 결과가 `Red Flag` 일 때만 생성)

    지속적인 모니터링이 필요하시면 [AML Ongoing Monitoring](/dashboard/ko/aml-ongoing-monitoring) 기능도 함께 활용해 주세요.
  </Accordion>
</AccordionGroup>

***

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

<CardGroup cols={2}>
  <Card title="고객 지원 요청" icon="headset" href="https://support.argosidentity.com/hc/ko/requests/new">
    지원 포털로 티켓을 남겨 주시면 담당자가 빠르게 답변드립니다.
  </Card>

  <Card title="영업 문의" icon="handshake" href="https://tally.so/r/wg946l">
    요구사항에 맞는 플랜과 기술 상담이 필요하시다면 영업팀에 문의해 주세요.
  </Card>
</CardGroup>