# Unico Developer Documentation

> Unico 신원 인증 플랫폼 문서: 사용 사례, 기능, SDK 및 API 레퍼런스.

## 문서

- [IDCloud](https://developer.unico.io/ko/index.md): Unico 개발자 포털 — 웹, Android, iOS, Flutter를 위한 IDCloud 신원 확인 API, SDK 및 기능 문서.
- 구축
  - [회원 가입](https://developer.unico.io/ko/products/sign-up.md): 전 세계 어디서나 신규 고객의 신원을 확인하고 안전한 등록을 보장합니다. 필요한 시나리오에 맞게 단일 여정으로 구성된 기능 세트입니다.
    - [Onboarding](https://developer.unico.io/ko/products/sign-up/onboarding/index.md): 모든 지역에서 활성도 감지, 생체 인식 신원 확인, 사기 위험 평가 및 문서 재사용을 통한 신원 확인.
    - [비문서 인증](https://developer.unico.io/ko/products/sign-up/non-document-verification/index.md): 모든 지역에서 활성 감지, 생체 인식 신원 확인 및 사기 위험 평가를 통한 신원 검증.
    - [사기 위험 수준 감지](https://developer.unico.io/ko/products/sign-up/fraud-risk-level-detection/index.md): 라이브니스와 행동 알림을 결합하여 실제 사람이 등록을 수행하고 있는지 검증합니다 — 문서 캡처나 정부 식별자를 통한 신원 확인이 필요 없습니다.
    - [다중 계정](https://developer.unico.io/ko/products/sign-up/multi-accounts.md): 사용자의 얼굴 생체 인식을 운영자의 등록 기반과 교차 참조하여 'One Face, One Contract' 원칙을 검증합니다.
  - [스텝업 인증](https://developer.unico.io/ko/products/step-up-authentication.md): 전 세계 어디서든 트랜잭션 플로우에서 고객의 신원을 확인하고 안전한 프로세스를 보장합니다. 필요한 시나리오에 맞춘 단일 여정 내의 기능 조합입니다.
    - [스마트 재검증](https://developer.unico.io/ko/products/step-up-authentication/smart-revalidation/index.md): 등록 이후 트랜잭션에서 사용자를 재인증하며, 원하는 경험과 플로우 중요도에 따라 인증 방법을 달리할 수 있습니다.
  - [지역별 솔루션](https://developer.unico.io/ko/products/regional-solutions.md): 지역 법률 및 법적 프레임워크로 인한 문제를 해결하기 위해 설계된 제품 — 현지 규제 요건에 맞춰 조정된 신원 확인 흐름.
    - [연령 인증](https://developer.unico.io/ko/products/regional-solutions/age-verification/index.md): 문서 마찰 없이 100% 생체 인식 방식으로 사용자가 최소 요구 연령을 충족함을 증명할 수 있습니다.
    - [데이터 검증](https://developer.unico.io/ko/products/regional-solutions/data-verification/index.md): 금융 서비스 및 iGaming에 관한 현행 규정을 기업이 준수할 수 있도록 필요한 개인 정보를 제공합니다.
    - [비대면 카드 검증](https://developer.unico.io/ko/products/regional-solutions/card-not-present-verification/index.md): 안면 인식 생체 인증과 카드 소유권 확인을 통해 비대면 카드 거래를 완료하는 사람이 정당한 신용카드 소유자인지 검증합니다.
- 기능
  - [라이브니스](https://developer.unico.io/ko/capabilities/liveness.md): 셀피 캡처 순간에 사용자가 실제 살아있는 사람임을 확인하는 기능. 거의 모든 IDCloud 플로우의 생체 인식 앵커.
  - [신원 확인](https://developer.unico.io/ko/capabilities/identity-verification.md): 캡처된 얼굴이 신분증 소지자에게 속하는지 확인하는 기능입니다.
  - [사기 위험 분류](https://developer.unico.io/ko/capabilities/fraud-risk-classification.md): 시간적 차원에서 거래를 평가하여 네트워크 효과를 통해 행동 이상 및 신원 사기를 감지합니다.
  - [위험 점수](https://developer.unico.io/ko/capabilities/risk-score.md): 결과가 "불확실"인 경우 신원 확인과 함께 사용되는 확률적 사기 점수를 생성하는 기능입니다.
  - [1:1 검증](https://developer.unico.io/ko/capabilities/1-1-validation.md): 현재 얼굴이 참조 프로세스에서 사용된 얼굴과 동일한지 확인하는 기능. 트랜잭션 플로우에서 일반적으로 사용됩니다.
  - [문서 재사용 및 캡처](https://developer.unico.io/ko/capabilities/document-reuse-and-capture.md): 문서를 요청, 저장 및 재사용하는 기능입니다. 분류, OCR, FaceMatch, CPF 매칭을 제공하여 문서 캡처가 있는 여정의 마찰을 줄입니다.
  - [Serpro 유사도 반환](https://developer.unico.io/ko/capabilities/serpro-similarity-return.md): 급여 담보 대출(INSS) 및 Serpro 데이터베이스와의 비교가 필요한 작업에 특화된 기능입니다. 촬영된 셀피와 Serpro에 등록된 사진 간의 유사도 점수를 반환합니다.
  - [스마트 재검증](https://developer.unico.io/ko/capabilities/smart-revalidation.md): 등록 이후 트랜잭션에서 사용자를 재인증하며, 원하는 경험과 플로우 중요도에 따라 인증 방법을 달리할 수 있습니다.
  - [다중 계정](https://developer.unico.io/ko/capabilities/multi-accounts.md): 운영자의 기반에서 1:N 생체 인식 검색을 수행하여 얼굴이 이미 다른 활성 계정에 연결되어 있는지 감지합니다.
  - [연령 인증](https://developer.unico.io/ko/capabilities/age-verification.md): 생체 인식 분석을 기반으로 카메라 앞의 사람이 법적 나이에 해당하는지 판단하는 기능입니다.
  - [Human Token](https://developer.unico.io/ko/capabilities/human-token.md): 셀피에서 안정적이고 불투명한 personId를 도출합니다 — 신원은 입력값이 아닌 호출의 출력값입니다. 사용자가 식별자를 선언하지 않습니다.
  - [Cardholder Verification](https://developer.unico.io/ko/capabilities/cardholder-verification.md): 이전에 검증된 프로세스를 해당 사람의 CPF 및 카드 데이터와 함께 재사용하여 카드가 신고된 소지자에게 속하는지 확인하는 기능입니다.
  - [사용 가능한 플로우](https://developer.unico.io/ko/capabilities/available-flows.md): IDCloud 플랫폼의 사전 구성된 플로우 전체 카탈로그입니다. 각 플로우는 준비된 기능들의 조합으로, POST /v1/process의 `flow` 필드에 전송됩니다.
- 리소스
  - [용어집](https://developer.unico.io/ko/resources/glossary.md): IDCloud 문서에 사용된 용어 목록 — 생체 인식, 라이브니스, 프로세스, 토큰 및 주요 개념.
  - [자주 묻는 질문](https://developer.unico.io/ko/resources/faq.md): IDCloud에 관한 자주 묻는 질문 — 통합, 인증, 오류 코드 및 지원 플랫폼.
  - [백테스트](https://developer.unico.io/ko/resources/backtests.md): 과거 데이터를 기반으로 기능 성능을 평가하는 히스토리 시뮬레이션을 실행합니다.
  - [재처리 및 생체 인식 데이터베이스 가져오기](https://developer.unico.io/ko/resources/reprocessing.md): Unico 플랫폼에서 생체 인식 기록을 재처리하거나 생체 인식 데이터베이스를 가져오기 위한 가이드입니다.

## 개발자

- [API 레퍼런스](https://developer.unico.io/ko/developers/api-reference.md): IDCloud API 레퍼런스 — 두 가지 공개 계약(Web & SDK 및 API).
  - [인증](https://developer.unico.io/ko/developers/api-reference/authentication.md): 모든 IDCloud 계약에서 사용하는 OAuth2 JWT Bearer 흐름. 자격 증명 획득, JWT 어서션 생성, 액세스 토큰 교환 방법을 알아보세요.
  - [환경](https://developer.unico.io/ko/developers/api-reference/environments.md): Web & SDK, API, Magic Link Mexico 계약에 걸친 샌드박스 및 프로덕션 호스트.
  - [Web & 네이티브](https://developer.unico.io/ko/developers/api-reference/web-sdk.md): Unico가 생체 인식 캡처를 호스팅하는 경우(iFrame, 리다이렉트 또는 네이티브 SDK)에 사용됩니다.
    - [프로세스 생성](https://developer.unico.io/ko/developers/api-reference/web-sdk/post-process.md): 검증 프로세스를 생성합니다. Unico에서 호스팅하는 캡처 경험으로 사용자를 안내하는 여정 URL과 SDK 토큰을 반환합니다.
    - [프로세스 조회](https://developer.unico.io/ko/developers/api-reference/web-sdk/get-process.md): 검증 프로세스의 현재 상태와 결과를 조회합니다.
    - [플로우](https://developer.unico.io/ko/developers/api-reference/web-sdk/flows.md): Web SDK에 사용 가능한 기능 레시피 카탈로그를 제품별로 정리하고, 각 레시피가 반환할 수 있는 결과 값을 안내합니다.
    - [프로세스 문서 설정](https://developer.unico.io/ko/developers/api-reference/web-sdk/post-process-document.md): 문서 없이 생성된 프로세스에 신분 증명 문서를 설정합니다. 문서가 필요한 기능을 트리거합니다.
    - [셀피 조회](https://developer.unico.io/ko/developers/api-reference/web-sdk/get-selfie.md): 인증 여정 중에 캡처된 워터마크가 적용된 셀피를 조회합니다.
    - [증거 세트 가져오기](https://developer.unico.io/ko/developers/api-reference/web-sdk/get-evidence-set.md): 프로세스의 전체 캡처 증거 번들을 검색합니다 — 컴플라이언스 및 규제 감사에 사용됩니다.
  - [API](https://developer.unico.io/ko/developers/api-reference/api.md): TCA / Check.Integration 계약 — 클라이언트가 캡처를 제어하고 요청에 직접 이미지를 전송하는 경우 사용합니다.
    - [프로세스 생성](https://developer.unico.io/ko/developers/api-reference/api/post-processes.md): 캡처된 이미지를 직접 전송하여 검증 프로세스를 생성합니다. 동기적 결과를 반환합니다.
    - [프로세스 조회](https://developer.unico.io/ko/developers/api-reference/api/get-process.md): 식별자로 기존 API 계약 프로세스를 조회합니다. 결과는 생성 시 동기적으로 반환되므로 재조회에 사용됩니다.
    - [플로우](https://developer.unico.io/ko/developers/api-reference/api/flows.md): API 계약에 사용 가능한 기능 레시피 카탈로그를 제품별로 정리하고, 각 레시피가 반환할 수 있는 결과 값을 안내합니다.
    - [재사용 가능한 문서 가져오기](https://developer.unico.io/ko/developers/api-reference/api/get-document.md): 새로운 캡처 플로우를 시작하기 전에 사용자에게 이미 재사용 가능한 문서가 있는지 확인합니다.
    - [문서 프로세스 생성](https://developer.unico.io/ko/developers/api-reference/api/post-processes-document.md): 새 문서를 캡처하거나 생체인식 프로세스와 연결된 이전에 캡처된 문서를 재사용합니다.
    - [데이터 검증](https://developer.unico.io/ko/developers/api-reference/api/get-lists.md): 주어진 CPF에 대한 등록 데이터, PEP/AML 심사 및 스포츠 관계를 조회합니다.
    - [연령 인증](https://developer.unico.io/ko/developers/api-reference/api/post-processes-age-validation.md): 연령 인증 프로세스를 생성합니다. 선택적으로 라이브니스 감지와 신원 확인을 단일 요청으로 결합합니다.
  - [SSO / SAML](https://developer.unico.io/ko/developers/api-reference/sso-saml.md): SAML을 통해 Single Sign-On(SSO)을 설정하면 사용자가 개별 Unico 자격 증명 대신 귀사 자체의 아이덴티티 제공자로 인증할 수 있습니다.
  - [오류 코드](https://developer.unico.io/ko/developers/api-reference/error-codes.md): Web & SDK, API, Magic Link 계약에 걸친 HTTP 및 플랫폼 오류 코드의 통합 목록.
  - [속도 제한](https://developer.unico.io/ko/developers/api-reference/rate-limits.md): 계약별 속도 제한, Retry-After 헤더, 그리고 예산 내에서 유지하기 위한 패턴.
  - [Postman 컬렉션](https://developer.unico.io/ko/developers/api-reference/postman.md): 인증, Web & SDK, API 계약을 위한 바로 사용 가능한 Postman 컬렉션.
- [SDK 및 도구](https://developer.unico.io/ko/developers/sdks-and-tools/overview.md): IDCloud SDK 및 통합 도구 개요 — Web SDK, Android SDK, iOS SDK, Flutter SDK, REST API.
  - [Android SDK](https://developer.unico.io/ko/developers/sdks-and-tools/android/requirements.md): | 요구 사항 | 버전 / 값 |
    - [설치](https://developer.unico.io/ko/developers/sdks-and-tools/android/installation.md): 프로젝트에 SDK를 구성하려면 다음 단계를 따르세요:
      - [특정 설정](https://developer.unico.io/ko/developers/sdks-and-tools/android/installation/specific-setup.md): SDK Key
    - [초기화](https://developer.unico.io/ko/developers/sdks-and-tools/android/initialization.md): SDK는 애플리케이션 로드 시 초기화하세요 — 일반적으로 Application 클래스나 진입 Activity의 onCreate에서 초기화합니다. 백엔드와의 SDK 인증에는 몇 초가 소요되므로, 조기에 초기화하면 사용자가 캡처 버튼을 탭하는 시점과 카메라가 열리는 시점 사이의 지연을 방지할 수 있습니다. 자세한 내용은 모범 사례를 참조하세요.
    - 캡처 흐름
      - 캡처 유형
        - [라이브니스 (생체 인식 셀피)](https://developer.unico.io/ko/developers/sdks-and-tools/android/capture-flow/capture-types/liveness.md): 내장된 라이브니스 검증을 갖춘 생체 인식 셀피 캡처. SDK는 SmartFrames를 통해 생체 인식적으로 유효한 프레임을 얻을 때까지 사용자를 안내하며, 이미지를 Base64 + JWT (JSON Web Token — REST API 호출을 위해 백엔드로 전송하는 서명된 페이로드) 형태로 반환합니다.
        - [사용자 여정](https://developer.unico.io/ko/developers/sdks-and-tools/android/capture-flow/capture-types/user-journeys.md): 사용자 여정(User Journeys)은 SDK가 설정된 플로우와 함께 조율하는 다단계 캡처 세션입니다. 예를 들어, 라이브니스 + 위험 점수 + 문서 캡처 + 전자 서명이 포함된 플로우는 단일 세션에서 셀피, 문서 캡처, 서명을 순서대로 실행합니다.
        - [사일런트 재검증](https://developer.unico.io/ko/developers/sdks-and-tools/android/capture-flow/capture-types/silent-revalidation.md): 사일런트 재검증 엔진을 사용하여 유니코의 네트워크 효과 내에서 사용자의 행동 컨텍스트를 분석하고 현재 거래에 대한 신뢰 신호를 제공합니다. 다시 말해, 해당 사용자가 거래에서 예상된 사용자일 신뢰 수준을 제공합니다.
      - [결과 수신](https://developer.unico.io/ko/developers/sdks-and-tools/android/capture-flow/receiving-the-result.md): SDK는 캡처 세션 중에 사용된 리스너 인터페이스에 정의된 콜백을 통해 캡처 결과를 반환합니다.
    - [커스터마이징](https://developer.unico.io/ko/developers/sdks-and-tools/android/customization.md): 이 커스터마이징은 캡처 플로우가 document-capture 또는 liveness인 경우에만 사용 가능합니다.
    - [오류 처리](https://developer.unico.io/ko/developers/sdks-and-tools/android/error-handling.md): Android SDK의 모든 오류 처리는 이 섹션에 집중되어 있습니다. onErrorAcessoBio 콜백은 code (Int)와 description (String)이 포함된 ErrorBio 객체를 수신합니다.
    - API 레퍼런스
      - [초기화 API](https://developer.unico.io/ko/developers/sdks-and-tools/android/api-reference/initialization-api.md): | 클래스 | 설명 |
      - [캡처 API](https://developer.unico.io/ko/developers/sdks-and-tools/android/api-reference/capture-api.md): SDK 빌더에서 얻은 UnicoCheckCamera 인터페이스에서 이 메서드를 호출하세요. 준비 완료 후 CameraListener.onCameraReady(cameraOpener) 콜백이 캡처를 시작할 opener를 제공합니다.
      - [콜백 / 리스너 인터페이스](https://developer.unico.io/ko/developers/sdks-and-tools/android/api-reference/callback-listener-interfaces.md): SDK 세션의 라이프사이클 콜백. AcessoBio 생성자에 구현체를 전달하세요.
      - [커스터마이제이션 API](https://developer.unico.io/ko/developers/sdks-and-tools/android/api-reference/customization-api.md): setTheme()을 사용하여 빌더에 테마 구현체를 전달하세요:
      - [열거형](https://developer.unico.io/ko/developers/sdks-and-tools/android/api-reference/enums.md): 캡처할 문서 유형을 정의합니다. prepareDocumentCamera에 전달하여 캡처 세션을 구성합니다.
    - [리소스](https://developer.unico.io/ko/developers/sdks-and-tools/android/resources.md): - 애플리케이션 로드 시 SDK를 초기화하세요. 캡처 버튼 클릭 시가 아닌, 앱 로드 시점에 초기화하세요. 백엔드 인증에 몇 초가 걸리며, 카메라 열기와 동시에 수행하면 지연이 발생한 것처럼 느껴집니다.
      - [알려진 문제](https://developer.unico.io/ko/developers/sdks-and-tools/android/resources/known-issues.md): - 릴리스 빌드는 실패하지만 디버그는 정상 동작 — 난독화 문제일 가능성이 높습니다. ProGuard/DexGuard 규칙을 검토하세요.
      - [릴리스 노트](https://developer.unico.io/ko/developers/sdks-and-tools/android/resources/release-notes.md): 항상 최신 버전으로 Android SDK를 업데이트하세요. 버전 번호는 시맨틱 버저닝을 따릅니다.
  - [iOS SDK](https://developer.unico.io/ko/developers/sdks-and-tools/ios/requirements.md): | 요구 사항 | 버전 / 값 |
    - [설치](https://developer.unico.io/ko/developers/sdks-and-tools/ios/installation.md): 1단계 — SDK 의존성 추가
      - [특정 설정](https://developer.unico.io/ko/developers/sdks-and-tools/ios/installation/specific-setup.md): SDK Key
    - [초기화](https://developer.unico.io/ko/developers/sdks-and-tools/ios/initialization.md): 클래스에서 AcessoBioConfigDataSource 프로토콜을 구현합니다:
    - 캡처 흐름
      - 캡처 유형
        - [라이브니스 (생체 인식 셀피)](https://developer.unico.io/ko/developers/sdks-and-tools/ios/capture-flow/capture-types/liveness.md): 내장된 라이브니스 검증을 통한 생체 인식 셀피 촬영으로, 촬영된 프레임을 Base64와 JWT로 반환합니다.
        - [사용자 여정](https://developer.unico.io/ko/developers/sdks-and-tools/ios/capture-flow/capture-types/user-journeys.md): 사용자 여정(User Journeys)은 SDK가 설정된 플로우와 함께 조율하는 다단계 캡처 세션입니다. 예를 들어, 라이브니스 + 위험 점수 + 문서 캡처 + 전자 서명이 포함된 플로우는 단일 세션에서 셀피, 문서 캡처, 서명을 순서대로 실행합니다.
        - [사일런트 재검증](https://developer.unico.io/ko/developers/sdks-and-tools/ios/capture-flow/capture-types/silent-revalidation.md): 사일런트 재검증 엔진을 사용하여 유니코의 네트워크 효과 내에서 사용자의 행동 컨텍스트를 분석하고 현재 거래에 대한 신뢰 신호를 제공합니다. 다시 말해, 해당 사용자가 거래에서 예상된 사용자일 신뢰 수준을 제공합니다.
      - [결과 수신](https://developer.unico.io/ko/developers/sdks-and-tools/ios/capture-flow/receiving-the-result.md): SDK는 촬영 세션 중에 사용된 델리게이트 인터페이스에 정의된 콜백을 통해 촬영 결과를 반환합니다.
    - [커스터마이징](https://developer.unico.io/ko/developers/sdks-and-tools/ios/customization.md): 이 커스터마이징은 캡처 플로우가 document-capture 또는 liveness인 경우에만 사용 가능합니다.
    - [오류 처리](https://developer.unico.io/ko/developers/sdks-and-tools/ios/error-handling.md): iOS SDK의 모든 오류 처리는 이 섹션에 집중되어 있습니다. onErrorAcessoBioManager 콜백은 getCode()와 getDescription()을 노출하는 ErrorBio 객체를 수신합니다.
    - API 레퍼런스
      - [초기화 API](https://developer.unico.io/ko/developers/sdks-and-tools/ios/api-reference/initialization-api.md): | 클래스 | 설명 |
      - [캡처 API](https://developer.unico.io/ko/developers/sdks-and-tools/ios/api-reference/capture-api.md): | 메서드 | 설명 |
      - [콜백 / 리스너 인터페이스](https://developer.unico.io/ko/developers/sdks-and-tools/ios/api-reference/callback-listener-interfaces.md): | 메서드 | 트리거 |
      - [커스터마이징 API](https://developer.unico.io/ko/developers/sdks-and-tools/ios/api-reference/customization-api.md): | 메서드 | 설명 |
      - [열거형](https://developer.unico.io/ko/developers/sdks-and-tools/ios/api-reference/enums.md): 캡처할 문서 유형을 정의합니다. 캡처 세션을 구성하기 위해 openDocument에 전달됩니다.
    - [리소스](https://developer.unico.io/ko/developers/sdks-and-tools/ios/resources.md): - 애플리케이션 로드 시 SDK를 초기화하십시오 (일반적으로 AppDelegate의 didFinishLaunchingWithOptions 또는 viewDidLoad에서). 캡처 버튼 클릭 시 초기화하지 마십시오. 백엔드와의 인증에 몇 초가 소요되며, 카메라 열기와 동시에 수행하면 지연 현상이 발생할 수 있습니다.
      - [알려진 문제](https://developer.unico.io/ko/developers/sdks-and-tools/ios/resources/known-issues.md): - 흐름 종료 시 그림자 발생 — 흐름 제어가 SDK 호출자에게 위임됩니다. 성공적인 캡처 후 그림자가 나타나거나 화면이 닫히지 않는 경우 onSuccessSelfie 내에 해제 구현을 추가하십시오:
      - [릴리스 노트](https://developer.unico.io/ko/developers/sdks-and-tools/ios/resources/release-notes.md): 항상 iOS SDK를 최신 버전으로 유지하십시오. 버전 번호는 시맨틱 버전 관리를 따릅니다.
  - [Flutter SDK](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/requirements.md): | 요구 사항 | 버전 / 값 |
    - [설치](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/installation.md): Flutter용 Unico SDK를 설정하려면 아래 단계를 따르세요:
      - [특정 설정](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/installation/specific-setup.md): SDK 키
    - [초기화](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/initialization.md): SDK를 애플리케이션 로드 시 — 일반적으로 main() 또는 진입 위젯의 initState()에서 초기화합니다. 캡처 버튼 클릭 시 초기화하지 않아야 하는 이유는 모범 사례를 참조하세요.
    - 캡처 흐름
      - 캡처 유형
        - [라이브니스 (생체 인식 셀피)](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/capture-flow/capture-types/liveness.md): 임베디드 라이브니스 검증을 포함한 생체 인식 셀피 캡처. SDK는 SmartFrames를 통해 생체 인식적으로 유효한 프레임을 얻을 때까지 사용자를 안내하고 이미지를 Base64 + JWT로 반환합니다.
        - [사용자 여정](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/capture-flow/capture-types/user-journeys.md): 사용자 여정은 구성된 흐름과 연계하여 SDK가 조율하는 다단계 캡처 세션입니다. 예를 들어, idchecktrustdocssign 흐름은 단일 세션에서 셀피 + 문서 + 서명을 실행합니다.
        - [사일런트 재검증](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/capture-flow/capture-types/silent-revalidation.md): 사일런트 재검증 엔진을 사용하여 유니코의 네트워크 효과 내에서 사용자의 행동 컨텍스트를 분석하고 현재 거래에 대한 신뢰 신호를 제공합니다. 다시 말해, 해당 사용자가 거래에서 예상된 사용자일 신뢰 수준을 제공합니다.
      - [결과 수신](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/capture-flow/receiving-the-result.md): SDK는 캡처 세션 중 사용된 리스너 인터페이스에 정의된 콜백을 통해 캡처 결과를 반환합니다.
    - [커스터마이징](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/customization.md): 이 커스터마이징은 캡처 플로우가 document-capture 또는 liveness인 경우에만 사용 가능합니다.
    - [오류 처리](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/error-handling.md): Flutter SDK의 모든 오류 처리는 이 섹션에 중앙 집중화되어 있습니다. onErrorUnico, onErrorSelfie, onErrorDocument 콜백은 getCode()와 getDescription()을 노출하는 UnicoError 객체를 수신합니다.
    - API 레퍼런스
      - [초기화 API](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/api-reference/initialization-api.md): | 클래스 | 설명 |
      - [캡처 API](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/api-reference/capture-api.md): | 메서드 | 설명 |
      - [콜백 / 리스너 인터페이스](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/api-reference/callback-listener-interfaces.md): | 메서드 | 트리거 |
      - [커스터마이징 API](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/api-reference/customization-api.md): | 메서드 | 설명 |
      - [열거형](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/api-reference/enums.md): 캡처할 문서 유형을 정의합니다. 캡처 세션을 구성하기 위해 openCameraDocument에 전달됩니다.
    - [리소스](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/resources.md): - 공식 Flutter 플러그인을 사용하세요. 브릿지를 통해 네이티브 SDK를 구현하지 마세요 — 이 방법은 Unico 엔지니어링 팀이 매핑하지 않은 오류를 생성합니다.
      - [알려진 문제](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/resources/known-issues.md): - 릴리스 빌드는 실패하지만 디버그는 작동함 — Android 측의 난독화 문제일 가능성이 높습니다. 네이티브 SDK는 난독화할 수 없습니다. ProGuard/DexGuard 규칙 검토.
      - [릴리스 노트](https://developer.unico.io/ko/developers/sdks-and-tools/flutter/resources/release-notes.md): Unico Flutter SDK 변경 로그 — 버전 기록, 새 기능, 버그 수정 및 네이티브 Android, iOS SDK 업데이트.
  - [웹 통합](https://developer.unico.io/ko/developers/sdks-and-tools/web.md): 웹 및 SDK 계약을 위한 클라이언트 측 통합 옵션 — 리다이렉트 흐름, iFrame SDK, JavaScript 캡처 라이브러리.
    - [Web SDK](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/requirements.md): 캡처 프레임은 WebRTC 및 아래 나열된 브라우저의 최신 버전을 지원합니다. 매우 오래된 버전에서는 기능이 보장되지 않습니다.
      - [설치](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/installation.md): CSP를 구성하고 Web SDK 패키지를 설치한 후 라이브니스 캡처에 필요한 리소스 파일을 다운로드하세요.
        - [특정 설정](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/installation/specific-setup.md): SDK 키
      - [초기화](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/initialization.md): 가능한 한 일찍 SDK를 초기화하세요 — 일반적으로 캡처 프레임이 포함된 페이지 또는 컴포넌트가 로드될 때 초기화합니다. 캡처 버튼 클릭 시 초기화하지 말아야 하는 이유에 대한 자세한 내용은 모범 사례를 참조하세요.
      - 캡처 흐름
        - 캡처 유형
          - [라이브니스 (생체 인식 셀피)](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/liveness.md): 내장된 라이브니스 검증을 포함한 생체 인식 셀피 캡처. SDK는 SmartFrames를 통해 생체 인식적으로 유효한 프레임이 획득될 때까지 사용자를 안내하고, 이미지를 Base64 + JWT로 반환합니다.
          - [문서 캡처](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/capture-flow/capture-types/document-capture.md): 신분증 캡처. SDK는 사용자가 문서를 올바르게 위치시킬 수 있도록 프레임을 제공하며, 위치 조정 후 사용자가 버튼을 클릭하여 사진을 캡처합니다.
        - [결과 수신](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/capture-flow/receiving-the-result.md): SDK는 open()에 전달된 callback 객체를 통해 캡처 결과를 반환합니다. success 및 error 핸들러 모두 필수입니다.
        - [모니터링 데이터 수집](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/capture-flow/monitoring-data-collection.md): 모니터링 및 옵저버빌리티 도구에서 사용자와 플로우를 식별하기 위해 캡처 세션에 선택적으로 첨부할 수 있는 메타데이터입니다.
      - [커스터마이징](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/customization.md): Web SDK는 언어와 시각적 테마의 두 가지 차원의 커스터마이징을 지원합니다.
      - [오류 처리](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/error-handling.md): Web SDK의 모든 오류 처리는 이 섹션에 집중되어 있습니다. error 콜백은 getCode() 및 getDescription()을 노출하는 ErrorBio 객체를 수신합니다.
      - [접근성](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/accessibility.md): SDK는 HTML 속성(aria-label, tabindex, role 등)을 갖춘 컴포넌트를 구현하여 요소 간 키보드 탐색을 가능하게 하고, 음성 안내를 활성화하며, 스크린 리더 소프트웨어에서 사용됩니다.
      - API 레퍼런스
        - [Initialization API](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/api-reference/initialization-api.md): | 클래스 | 설명 |
        - [Capture API](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/api-reference/capture-api.md): | 메서드 | 설명 |
        - [콜백 / 리스너 인터페이스](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/api-reference/callback-listener-interfaces.md): Web SDK는 플랫폼별 리스너 인터페이스 대신 open()에 전달되는 단일 callback 객체를 사용합니다.
        - [Customization API](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/api-reference/customization-api.md): | 메서드 | 설명 |
        - [Enums](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/api-reference/enums.md): 셀피 캡처의 카메라 모드를 정의합니다. prepareSelfieCamera에 전달됩니다.
      - [리소스](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/resources.md): - 캡처 버튼 클릭 시가 아니라 페이지 로드 시 SDK를 초기화하세요. 백엔드 인증에는 몇 초가 걸리며, 카메라 열기와 동시에 수행하면 지연 느낌이 발생합니다.
        - [알려진 문제](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/resources/known-issues.md): - CSP가 SDK 로딩을 차단함 — 필수 CSP 지시어(worker-src, script-src 등)가 없으면 Web SDK가 Web Worker와 추가 리소스를 로드하지 못합니다. CSP 구성을 검토하세요.
        - [릴리스 노트](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-sdk/resources/release-notes.md): Web SDK를 항상 최신 버전으로 유지하세요. 버전 번호는 시맨틱 버저닝을 사용합니다.
    - [웹 앱 통합](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-integration.md): 클라이언트 측에서 웹 및 SDK 계약을 통합하는 방법 — 리다이렉트 흐름 및 iFrame SDK 설정.
      - [리소스](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-integration/resources.md): Unico Web App Integration SDK(unico-journey-sdk) 통합을 위한 모범 사례 및 릴리스 노트.
        - [릴리스 노트](https://developer.unico.io/ko/developers/sdks-and-tools/web/web-integration/resources/release-notes.md): Unico Web App Integration SDK(unico-journey-sdk)의 변경 이력 — 버전 이력, 새로운 기능 및 업그레이드 참고 사항.
  - [캡처 스탠다드](https://developer.unico.io/ko/developers/sdks-and-tools/capture-standard.md): IDCloud 플랫폼 기능의 최적 성능을 위해 당사 SDK(Web, Android, iOS, Flutter) 사용을 권장합니다. SDK는 이탈률과 Liveness 검증 측면에서 제품 전반의 최상의 기능을 보장합니다.
  - [모범 사례](https://developer.unico.io/ko/developers/sdks-and-tools/best-practices-for-sdk-implementation.md): Unico SDK를 안전하게 통합, 업데이트, 테스트, 배포하기 위한 지침(스테이징(UAT) 환경 보안 규칙 포함).
  - [업데이트 정책](https://developer.unico.io/ko/developers/sdks-and-tools/update-policy.md): Unico SDK 업데이트 정책: 정책이 존재하는 이유, 고객이 준수해야 하는 최소 기한, 지원과 보호를 유지하는 방법.
- [웹훅 및 이벤트](https://developer.unico.io/ko/developers/webhooks-and-events.md): IDCloud 웹훅 소개 — 신원 확인 프로세스 이벤트에 대한 실시간 알림 수신.
  - [설정](https://developer.unico.io/ko/developers/webhooks-and-events/setup.md): IDCloud 웹훅 구성 단계별 가이드 — 웹 및 SDK를 위한 포털 셀프서비스와 Check 오케스트레이션을 사용하는 API 통합을 위한 클라이언트별 구성(브라질 전용).
  - [이벤트 유형](https://developer.unico.io/ko/developers/webhooks-and-events/event-types.md): IDCloud 웹훅 이벤트 유형 참조 — 프로세스 완료, 실패, 상태 변경 페이로드.
  - [보안](https://developer.unico.io/ko/developers/webhooks-and-events/security.md): IDCloud 웹훅 페이로드 검증 및 보안 방법 — 서명 검증 및 모범 사례.
  - [폴백 전략](https://developer.unico.io/ko/developers/webhooks-and-events/fallback.md): webhook 서비스가 일시적으로 사용 불가능할 때 프로세스 결과를 조회하는 방법.
- [AI 에이전트 통합](https://developer.unico.io/ko/developers/llms.md): 모든 페이지의 Markdown 버전, 언어별 llms.txt 인덱스, 페이지 작업 바를 통해 AI 에이전트와 LLM 도구에서 이 문서를 읽을 수 있습니다.
- 지역별 솔루션
  - [비대면 카드 검증](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification.md): 비대면 카드 검증 REST API 문서 — 결제 거래에서 구매자 신원 확인과 신용카드 소유자 검증을 결합합니다.
    - 비대면 카드 검증 소개
      - [비대면 카드 검증이란](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/about-idpay/unico-id-pay.md): 비대면 카드 검증이 무엇인지와 결제 거래에서 제공하는 보증 사항: 라이브니스, 카드 소유자 신원 일치, 그리고 책임 보호.
      - [기능](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/about-idpay/feature.md): 비대면 카드 검증의 핵심 기능인 결제 거래와 신용카드 온보딩, 그리고 이 두 기능의 차이점.
      - [사용 사례](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/about-idpay/use-cases.md): 체크아웃, 사전 분석, 분석 도구, 매출 회수, 신용카드 온보딩에 걸친 비대면 카드 검증의 사용 사례.
      - [Chargeback](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/about-idpay/chargeback.md): 비대면 카드 검증에 대한 Unico의 차지백 책임 보증: 적용 시점, 전제 조건 및 제외 사항.
    - [통합](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/overview.md): 비대면 카드 검증의 단계별 통합 개요: 인증, 경험 커스터마이징, 거래 생성, 웹훅 알림 처리.
      - [인증](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/authentication.md): 비대면 카드 검증은 REST API용 액세스 토큰을 발급하기 위해 OAuth2 서비스 계정(2-legged) 인증을 사용합니다.
        - [서비스 계정 생성](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/authentication/creating-a-service-account.md): 서버 대 서버 비대면 카드 검증 인증을 위한 서비스 계정 요청 방법(키 쌍 생성 포함).
        - [API에 인증된 요청을 보내기 위한 준비](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/authentication/preparing-authenticated-request.md): JWT를 생성하고 서명하는 방법, OAuth2 플랫폼에 액세스 토큰을 요청하는 방법, 토큰 응답과 만료를 처리하는 방법.
        - [추가 자료](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources.md): 비대면 카드 검증 인증을 위한 지원 리소스: JavaScript 구현 예제, 인증 오류 코드, Postman 컬렉션.
          - [JavaScript 예제](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/example-in-javascript.md): JWT를 생성하고 서명하며 비대면 카드 검증 액세스 토큰을 요청하는 참조용 JavaScript 구현.
          - [인증 오류](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/authentication-errors.md): 비대면 카드 검증 OAuth2 인증 플랫폼이 반환하는 오류 코드와 각각의 해결 방법.
          - [Postman 컬렉션](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/authentication/additional-resources/postman-collection.md): 결제 거래, Chargeback, 신용카드 온보딩을 포함한 비대면 카드 검증 REST API용 즉시 사용 가능한 Postman 컬렉션입니다.
      - [API](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis.md): 비대면 카드 검증 제품에서 사용 가능한 모든 REST 엔드포인트: API 레퍼런스, 오류, 열거형 값.
        - [API 레퍼런스](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference.md): 비대면 카드 검증 REST API의 엔드포인트 레퍼런스: 결제 거래, Chargeback, 신용카드 온보딩, 컨텍스트 신호.
          - [결제 거래](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/payment-transactions.md): 비대면 카드 검증에서 결제 거래 생성, 상태 확인, 증빙 조회, 알림 재전송을 위한 REST API 레퍼런스.
          - [Chargeback](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/chargeback.md): 비대면 카드 검증에서 Chargeback 검토를 요청하고 상태를 확인하기 위한 REST API 레퍼런스.
          - [신용카드 Onboarding](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/credit-card-onboarding.md): 비대면 카드 검증의 신용카드 Onboarding 기능에서 신용카드를 검증하고 검증 상태를 확인하기 위한 REST API 레퍼런스.
          - [컨텍스트 신호](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/api-reference/context-signals.md): 비대면 카드 검증에서 완료된 신용 거래의 사기 위험 평가(자기 사기 또는 소셜 엔지니어링)를 조회하기 위한 REST API 레퍼런스.
        - [오류](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/errors.md): 비대면 카드 검증 REST API 엔드포인트가 반환하는 HTTP 상태 코드와 오류 응답에 대한 개요.
        - [열거형](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/apis/enumerated.md): 비대면 카드 검증 REST API 전반에서 사용되는 열거형: 거래 결과 코드와 Chargeback 결과 코드.
      - [웹훅](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/webhook.md): 비대면 카드 검증 웹훅 알림을 설정하고 수신하는 방법: 요청/응답 형식과 요청 제한, 멱등성 같은 중요 고려 사항.
      - [경험 제어](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/overview.md): 비대면 카드 검증 SDK 통합 방식의 작동 원리 — Webview, SDK, Redirect 표준과 애플리케이션에 통합하기 전에 필요한 API 단계.
        - [요구 사항](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/requirements.md): 비대면 카드 검증 SDK 캡처 프레임을 위한 최소 OS 버전과 브라우저/OS 호환성 매트릭스.
        - Mobile
          - [Android](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/android.md): CustomTabs를 통한 Android에서의 비대면 카드 검증 캡처 경험 관리: 의존성, 탭 열기, 매니페스트 설정, 콜백 읽기.
          - [iOS](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios.md): iOS에서 비대면 카드 검증 캡처 경험을 관리하는 두 가지 권장 방법: WKWebView와 ASWebAuthenticationSession.
            - [WKWebView](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/wkwebview.md): WKWebView를 사용하여 iOS에서 비대면 카드 검증 캡처 경험을 구현하는 방법: 뷰 열기, 닫는 시점 제어, 필요한 권한.
            - [ASWebAuthenticationSession](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/ios/aswebauthenticationsession.md): ASWebAuthenticationSession을 사용하여 iOS에서 비대면 카드 검증 캡처 경험을 구현하는 방법: 인증 컨트롤러, 세션 설정, 필요한 권한.
          - [Flutter](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/mobile/flutter.md): inappwebview를 통한 Flutter에서의 비대면 카드 검증 캡처 경험 관리: 웹뷰 열기, URL 변경 감지, 카메라 권한.
        - Web
          - [SDK](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/sdk.md): 웹용 Unico SDK를 구현하는 방법: 설치, init/open 메서드, 전체 화면 가이드, iFrame + 인증 토큰 보안 모델.
          - [리다이렉트(지원 중단됨)](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/controlling-the-experience/web/redirect-deprecated.md): 비대면 카드 검증을 위한 지원 중단된 웹 통합 모델: window.open()과 전체 페이지 리다이렉트. 더 나은 전환율을 위해서는 SDK를 사용하는 것이 좋습니다.
      - [커스터마이징](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/customizations.md): 비대면 카드 검증 경험을 위한 로고, 버튼 색상 및 모양 커스터마이징 옵션과 접근성 대비 권장 사항.
      - [Silent Verification](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/integration/silent-verification.md): 재방문 사용자를 위해 비대면 카드 검증에서 백그라운드 검증을 활성화합니다. 신호와 반복성을 활용하여 거래를 무음으로 승인할 수 있는지 판단합니다.
    - 도움말 및 FAQ
      - [효과적인 커뮤니케이션 모범 사례](https://developer.unico.io/ko/developers/regional-solutions/card-not-present-verification/help-and-faq/best-communication-practices.md): 최종 사용자와의 마찰 및 지원 문의를 줄이기 위해 비대면 카드 검증의 생체 인식 신원 검증 절차를 안내하는 방법에 대한 팁.

## Product Guide

- [제품 가이드](https://developer.unico.io/ko/product-guide.md): 유니코 제품 운영 매뉴얼 — 모든 화면, 모든 필드, 모든 설정을 단계별로 사용하는 방법.
- [IDCloud 포털](https://developer.unico.io/ko/product-guide/portal-idcloud.md): IDCloud 포털 운영 가이드 — 고객 경험, 시스템 알림, QR 코드 검증을 구성합니다.
  - 설정
    - [여정 커스터마이징](https://developer.unico.io/ko/product-guide/portal-idcloud/settings/journey-customization.md): IDCloud 포털에서 직접 여정의 시각적 아이덴티티 — 로고, 색상, 배경, 버튼 모양 — 를 실시간 미리보기와 함께 구성합니다.
    - [웹훅](https://developer.unico.io/ko/product-guide/portal-idcloud/settings/webhook.md): 여정 상태가 변경될 때 IDCloud가 시스템에 알리는 위치, API에 대한 인증 방식, API가 응답하지 않을 때 발생하는 일을 설정합니다.
    - [QR 코드](https://developer.unico.io/ko/product-guide/portal-idcloud/settings/qr-code.md): IDCloud 포털에서 직접 검증 여정의 QR 코드 표시를 활성화하여 고객이 데스크톱에서 시작하고 모바일에서 계속할 수 있게 합니다.