개요

계약 선택은 생체 캡처가 발생하는 위치의 결과이지 독립적인 결정이 아닙니다. 아래 표를 참조하세요.

계약	사용 시기	캡처	플로우
Web & SDK	캡처 여정이 Unico(Web iFrame, Redirect 또는 네이티브 SDK)에 의해 호스팅될 때	Unico가 제어	프로세스가 캡처 전에 생성됨 → 사용자가 여정을 진행 → 콜백 또는 폴링으로 결과 반환
API	애플리케이션이 캡처를 제어하고(Unico SDK 유무에 관계없이) 이미지를 직접 호출에 전송할 때	클라이언트가 제어	이미지가 프로세스 생성과 함께 전송됨 → 결과가 동기적으로 반환됨

계약	샌드박스 호스트	프로덕션 호스트
Web & SDK	`https://api.idcloud.uat.unico.app`	`https://api.idcloud.unico.app`
API	`https://api.id.uat.unico.app`	`https://api.id.unico.app`
OAuth2 / Token	`https://identityhomolog.acesso.io`	`https://identity.acesso.io`

전체 세부 정보는 환경을 참조하세요.

모든 Unico 계약은 urn:ietf:params:oauth:grant-type:jwt-bearer를 통한 OAuth2로 획득한 **Bearer 토큰(JWT)**을 사용합니다.

전체 세부 정보는 인증을 참조하세요.

동일한 개념적 작업("신원 확인 프로세스 생성")은 각 계약에서 다르게 보입니다. 통합 간 마이그레이션 시 아래 표를 빠른 참조로 사용하세요.

Process creation

항목	Web & SDK	API
엔드포인트	`POST /client/v1/process`	`POST /processes/v1`
인증	`Authorization: Bearer <jwt>`	`Authorization: Bearer <jwt>` + `APIKEY`
이미지	전송 안 함(Unico 여정에서 캡처)	`imageBase64`로 전송
사용자 식별	`person.duiType` + `person.duiValue`	`subject.code` (CPF / CURP)
문서 유형	CPF, CURP, SSN, NIN, DNI, NIK	CPF, CURP만
파이프라인 정의	`flow` (열거형, 30+ 값)	`APIKEY`에 암시적(기능)
콜백	`callbackUri` (사용자 리디렉션)	없음(동기식)
웹훅	Webhook v1 (최종 결과)	Webhook v1 (선택 사항)
여정 URL 반환	예 (`userRedirectUrl`)	아니오
결과	비동기(GET 폴링 또는 웹훅)	동기식(응답에 포함)
SDK 토큰	예 (`token`, `webAppToken`)	아니오

Result retrieval

항목	Web & SDK	API
엔드포인트	`GET /client/v1/process/\{id\}`	`GET /processes/v1/\{id\}` (생성 응답에도 포함)
상태	`state` + `result` (접두사가 붙은 열거형)	`status` (1, 3, 5)
결과 구조	`process.authenticationInfo.{capability}Result` 아래에 중첩	평탄: `unicoId`, `liveness`, `government`, `identityFraudsters`
문서	`services[].documents[]` (OCR이 있는 RG/CNH)	별도 엔드포인트(`GET /processes/v1/\{id\}/document`)