이 페이지는 GET/Submission API의 응답 필드에 대한 상세 정의를 제공합니다.
응답 데이터 (ID Document)
| 필드명 | 설명 | 데이터 타입 | 카테고리 |
|---|---|---|---|
data | KYC 제출자 데이터 | Object | KYC 제출자 정보 |
data.age_group | 제출자의 연령대: minor, early-teen, teen, adult | String | KYC 제출자 정보 |
data.first_name | 제출자의 First Name | String | KYC 제출자 정보 |
data.last_name | 제출자의 Last Name | String | KYC 제출자 정보 |
data.full_name | 제출자의 Full Name | String | KYC 제출자 정보 |
data.gender | 제출자의 성별 (male 또는 female) | Enum | KYC 제출자 정보 |
data.nationality | ISO alpha-3 형식의 국가 코드 | String | KYC 제출자 정보 |
data.date_of_birth | 제출자의 생년월일 (YYYY-MM-DD 형식) | Date | KYC 제출자 정보 |
data.ip_address | IPv4 형식의 IP 주소 | String | KYC 제출자 정보 |
data.idType | 사용된 신분증 유형 | Enum | KYC 제출자 정보 |
data.idcard_issuingCountry | 신분증 발급 국가의 ISO alpha-3 형식 코드 ISO Alpha-3 국가 코드 | String | KYC 제출자 정보 |
data.idcard_issueDate | 신분증 발급일 (YYYY-MM-DD 형식) | String | KYC 제출자 정보 |
data.idcard_expireDate | 신분증 만료일 (YYYY-MM-DD 형식) | String | KYC 제출자 정보 |
data.identityNumber | 주민등록번호 | String | KYC 제출자 정보 |
data.documentNumber | 신분증 번호 | String | KYC 제출자 정보 |
data.address_city | 도시 | String | KYC 제출자 정보 |
data.address_country | 국가 | String | KYC 제출자 정보 |
data.address_state | 주 | String | KYC 제출자 정보 |
data.address_street | 도로 | String | KYC 제출자 정보 |
data.address_street2 | 도로2 (추가 주소 정보) | String | KYC 제출자 정보 |
data.address_zipcode | 우편번호 | String | KYC 제출자 정보 |
data.address_globalCode | 글로벌 주소 코드 (예: 8Q98HXPG+MP) | String | KYC 제출자 정보 |
data.address_compoundCode | 복합 주소 코드 (예: HXPG+MP 서울, 대한민국) | String | KYC 제출자 정보 |
data.address_formatted | 변환된 상세 주소 | String | KYC 제출자 정보 |
data.address_input | 사용자가 입력한 주소 | String | KYC 제출자 정보 |
data.address_detail | 사용자가 입력한 상세 주소 | String | KYC 제출자 정보 |
data.cf1 | 사용자 정의 필드 #1 | String | KYC 제출자 정보 |
data.cf2 | 사용자 정의 필드 #2 | String | KYC 제출자 정보 |
data.cf3 | 사용자 정의 필드 #3 | String | KYC 제출자 정보 |
data.typeOfPermit | 신분증에 부여된 제출자의 체류자격이나 종류 | String | KYC 제출자 정보 |
data.typeOfPermitGovKor | 한국 법무부에 등록된 제출자의 체류자격이나 종류 | String | KYC 제출자 정보 |
data.expiryDateOfStayKor | 한국 법무부에 등록된 체류기간 만료일 (YYYY-MM-DD 형식) | String | KYC 제출자 정보 |
data.nationalityGovKor | 한국 법무부에 등록된 제출자의 국적 (예: 미국인) | String | KYC 제출자 정보 |
image | ArgosServer에서 ID 문서 및 셀피에 대한 이미지 링크를 포함하는 이미지 객체; GET/Image를 사용해서만 이미지를 다운로드할 수 있음 | Object | 제출 정보 |
image.idImage | ArgosServer의 ID 문서 이미지 링크; 이미지를 다운로드할 수 없음 | String | 제출 정보 |
image.idBackImage | ArgosServer의 ID 문서 뒷면 이미지 링크; 이미지를 다운로드할 수 없음 | String | 제출 정보 |
image.selfieImage | ArgosServer의 셀피 이미지 링크; 이미지를 다운로드할 수 없음 | String | 제출 정보 |
image.addressImage | ArgosServer의 주소 문서 이미지 링크; 이미지를 다운로드할 수 없음 | String | 제출 정보 |
memo | 대시보드 제출 메모 객체 | Object | 대시보드 정보 |
memo.text | 대시보드 제출 메모 내용 | string | 대시보드 정보 |
memo.updated_at | 대시보드 제출 메모 업데이트 시간 | string | 대시보드 정보 |
duplicated_users | 중복된 PII를 가진 것으로 발견된 제출 ID 목록 | Array | KYC 제출자 정보 |
duplicated_selfie_users | 중복된 얼굴을 가진 것으로 발견된 제출 ID 목록 | Array | KYC 제출자 정보 |
OCR_raw.rotate.value | OCR 이 인식된 각도 | String | KYC 제출자 정보 |
OCR_raw.{item}.value | 인식된 OCR 의 값 | String | KYC 제출자 정보 |
OCR_raw.{item}.score | 인식률 점수 (0~100) | Int | KYC 제출자 정보 |
OCR_raw.{item}.accepted | 인식 성공 여부 | Bool | KYC 제출자 정보 |
OCR_raw.{item}.coordinates | 인식된 OCR 의 벡터 데이터 | Object | KYC 제출자 정보 |
ocr.birthDate | OCR 인식 제출자의 생년월일 (YYYY-MM-DD 형식) | Date | KYC 제출자 정보 |
ocr.issueDate | OCR 인식 발급일자 | Date | KYC 제출자 정보 |
ocr.expireDate | OCR 인식 만료일자 | Date | KYC 제출자 정보 |
ocr.firstName | OCR 인식 제출자의 First Name | String | KYC 제출자 정보 |
ocr.lastName | OCR 인식 제출자의 Last Name | String | KYC 제출자 정보 |
ocr.fullName | OCR 인식 제출자의 Full Name | String | KYC 제출자 정보 |
ocr.gender | OCR 인식 제출자의 성별 ( male 또는 female ) | Enum | KYC 제출자 정보 |
ocr.number | OCR 인식 문서번호 (Document Number) | String | KYC 제출자 정보 |
ocr.licenseNumber | OCR 인식 면허번호 | String | KYC 제출자 정보 |
ocr.identityNumber | OCR 인식 주민등록번호 | String | KYC 제출자 정보 |
ocr.curpNumber | OCR 인식 MEX.ID 의 Curp Number | String | KYC 제출자 정보 |
ocr.nationality | OCR 인식 ISO alpha-3 형식의 국가 코드 | String | KYC 제출자 정보 |
ocr.serialNumber | OCR 인식 일련번호 | String | KYC 제출자 정보 |
ocr.typeOfPermit | OCR 인식 체류자격 유형 (예: F-4) | String | KYC 제출자 정보 |
review.birthDate | 제출자의 생년월일 (YYYY-MM-DD 형식) | Date | KYC 제출자 정보 |
review.issueDate | 발급일자 | Date | KYC 제출자 정보 |
review.expireDate | 만료일자 | Date | KYC 제출자 정보 |
review.fullName | 제출자의 Full Name | String | KYC 제출자 정보 |
review.gender | 제출자의 성별 ( male 또는 female ) | Enum | KYC 제출자 정보 |
review.nationality | ISO alpha-3 형식의 국가 코드 | String | KYC 제출자 정보 |
review.documentNumber | 문서번호 | String | KYC 제출자 정보 |
review.licenseNumber | 면허번호 | String | KYC 제출자 정보 |
review.identityNumber | 주민등록번호 | String | KYC 제출자 정보 |
review.curpNumber | MEX.ID 의 Curp Number | String | KYC Applicant Info |
email | 제출과 연관된 이메일 주소 | String | KYC 제출자 정보 |
reviewer | 검수 유형: system은 AI 시스템 검수, agent는 사람 검수를 나타냄 | Enum | KYC 검수 정보 |
Injection_action.attemptStatus | Injection 시도 결과 | String | KYC injection 정보 |
Injection_action.createTime | Injection 생성일시 (UTC+0) *순서: 최신이 최상단, 이후 오래된 순서 정렬 | String | KYC injection 정보 |
Injection_action.userInput.address | 유저가 입력한 주소 정보 | Object | KYC injection 정보 |
Injection_action.option.distanceChecks | Injection 거리 측정에 사용된 서비스와 거리 정보 | Object | KYC injection 정보 |
Injection_action.option.ipRisk | IP 위험 평가 카테고리 및 차단 시간 정보 | Object | KYC injection 정보 |
Injection_action.option.ipVerification | Injection 진행 시 확인된 IP 정보 | Object | KYC injection 정보 |
submission_id | 각 제출 건에 부여된 고유 식별자 | String | 제출 정보 |
recognition_score | 신분증 인식 점수 | Float | 제출 정보 |
argos_score | ARGOS 시스템의 종합 평가 점수 | Float | 제출 정보 |
duplicated_information | 이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.) | String | 제출 정보 |
custom_duplicated_information | 사용자 정의 중복 확인 규칙에 의해 생성된 식별자 | String | 제출 정보 |
applicant_id | 중복 제출된 사용자에 부여된 식별자 | String | 제출 정보 |
created_at | 제출된 날짜와 시간 (UTC+0) | String | 제출 정보 |
kyc_result_at | KYC 결과가 최종적으로 결정된 날짜와 시간 | String | 제출 정보 |
updated_at | 마지막으로 제출 정보가 업데이트된 날짜와 시간 | String | 제출 정보 |
pending_at | KYC가 보류(Pending) 상태로 표시된 날짜와 시간 | String | 제출 정보 |
userid | 제출 생성 시 선택적으로 추가된 파라미터 | String | 제출 정보 |
project_options | 프로젝트 설정 옵션을 포함하는 객체 | Object | 프로젝트 설정 정보 |
project_options.option_aml | AML 스크리닝 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
project_options.option_addressData | 주소 데이터 수집 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
project_options.policy_approvePeriod | 자동 승인 기간 (일 단위, 0이면 자동 승인 비활성화) | Number | 프로젝트 설정 정보 |
project_options.option_idNumber | 신분증 번호 수집 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
project_options.policy_blacklistCountries | 블랙리스트 국가 목록 (ISO alpha-3 형식의 국가 코드 배열) | Array | 프로젝트 설정 정보 |
project_options.policy_acceptedID | 허용된 신분증 유형 목록 (예: government_id, passport, drivers_license 등) | Array | 프로젝트 설정 정보 |
project_options.option_mask_documentNumber | 문서 번호 마스킹 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
project_options.option_validationGov | 한국 정부 진위확인 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
project_options.webhook | 웹훅 설정 정보를 포함하는 객체 | Object | 프로젝트 설정 정보 |
project_options.webhook.createTime | 웹훅 생성 시간 (ISO 8601 형식) | String | 프로젝트 설정 정보 |
project_options.webhook.members | 웹훅 멤버 정보 배열 | Array | 프로젝트 설정 정보 |
project_options.webhook.url | 웹훅 URL | String | 프로젝트 설정 정보 |
project_options.option_mask_idNumber | ID 번호(주민등록번호) 마스킹 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
project_options.option_documentNumber | 문서 번호 수집 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
project_options.webhookURL | 웹훅 URL (단순 문자열) | String | 프로젝트 설정 정보 |
project_options.policy_ageLimit | 연령 제한 정책 (최소 연령) | Number | 프로젝트 설정 정보 |
project_options.option_ai_only | AI 전용 심사 사용 여부 (true: 사용, false: 미사용) | Boolean | 프로젝트 설정 정보 |
additional_list | 대시보드에서 설정된 추가 양식에 대해 사용자가 입력한 데이터 | Array | 추가 양식 정보 |
additional_list.answer | 각 추가 양식 필드의 이름 | String | 추가 양식 정보 |
additional_list.inputValue | 각 필드에 대한 사용자 입력 값 | String | 추가 양식 정보 |
additional_list.blockType | 각 추가 양식 필드의 데이터 타입 | String | 추가 양식 정보 |
kyc | KYC 결과를 포함하는 객체 KYC 상태 | Object | KYC 결과 정보 |
kyc.result | KYC 프로세스의 상태 | Enum | KYC 결과 정보 |
kyc.comment | KYC 거절 사유 거절 코드 및 사유 | String | KYC 결과 정보 |
kyc.commentCode | KYC 거절 사유를 나타내는 코드 거절 코드 및 사유 | String | KYC 결과 정보 |
kyc.attempts[i].attemptCnt | 실패 후 재시도한 횟수 | Number | KYC 시도 정보 |
kyc.attempts[i].idBarcodeResult | 미국, 캐나다, 멕시코 신분증의 바코드 검증 결과 | String | KYC 시도 정보 |
kyc.attempts[i].ocrResult | OCR 인식 결과 (success, fail) | Enum | KYC 시도 정보 |
kyc.attempts[i].verificationResult | 신분증 진위 확인 결과 (success, fail) | Enum | KYC 시도 정보 |
kyc.attempts[i].verification | 신분증 진위 확인 결과의 상세 데이터 | Object | KYC 시도 정보 |
kyc.attempts[i].verificationParams | 신분증 진위 확인 실행 시 필요한 매개변수 | Object | KYC 시도 정보 |
kyc.attempts[i].errorCode | 얼굴 인식, 비교, 신분증 진위 확인 중 발생한 오류 코드 | String | KYC 시도 정보 |
kyc.attempts[i].errorMsg | 얼굴 인식, 비교, 신분증 진위 확인 중 발생한 오류 메시지 | String | KYC 시도 정보 |
kyc.attempts[i].step1Time1st | step1 첫 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step1Time2nd | step1 두 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step1Time3rd | step1 세 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step2Time1st | step2 첫 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step2Time2nd | step2 두 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step2Time3rd | step2 세 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].retryMsg | 얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 메시지 | String | KYC 시도 정보 |
kyc.attempts[i].retryCode | 얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 코드 | String | KYC 시도 정보 |
kyc.attempts[i].faceSimilarityScore | 얼굴 비교 유사도 점수 | Float | KYC 시도 정보 |
kyc.attempts[i].selfieImage | 제출된 셀피 이미지의 URL | String | KYC 시도 정보 |
kyc.attempts[i].livenessScore | 시도의 생체 인증 점수 | Float | KYC 시도 정보 |
kyc.attempts[i].liveness | 생체 인증 점수의 상세 데이터 (score, probability, quality 포함) | Object | KYC 시도 정보 |
kyc.attempts[i].liveness.score | 생체 인증의 전체 점수 | Float | KYC 시도 정보 |
kyc.attempts[i].liveness.probability | 생체 인증의 확률 값 | Float | KYC 시도 정보 |
kyc.attempts[i].liveness.quality | 생체 인증의 품질 점수 | Float | KYC 시도 정보 |
verification | 얼굴 기반 나이 검증 결과를 포함하는 객체 | Object | 얼굴 나이 검증 정보 |
verification.faceAge | 얼굴 기반 나이 검증의 전체 결과 배열 (매 시도별 누적 기록) | Array | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues | 검증에 사용된 나이 값들 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalSelfieLow | LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalSelfieHigh | LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalSelfieMedian | LOW/HIGH 확장 설정 적용 전 셀피 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalIdLow | LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalIdHigh | LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalIdMedian | LOW/HIGH 확장 설정 적용 전 신분증 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.selfieLow | LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.selfieHigh | LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.selfieMedian | LOW/HIGH 확장 설정 적용 후 셀피 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.idLow | LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.idHigh | LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.idMedian | LOW/HIGH 확장 설정 적용 후 신분증 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.birthDateAge | 사용자 입력 생년월일로 계산한 만 나이 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults | 각 조건식별 검증 결과 배열 | Array | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].condition | 조건식 설정 정보 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].condition.comparisonOperator | 비교 연산자 (gte: 이상, gt: 초과, lte: 이하, lt: 미만) | String | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].condition.target | 비교 대상 나이 유형 (low, high, median) | String | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].conditionIndex | 조건식 인덱스 (0부터 시작) | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].finalResult | 해당 조건식의 최종 검증 결과 (true: 성공, false: 실패) | Boolean | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults | 각 타겟 이미지와 기준 나이 조합별 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.idCardCustomMatch | 신분증 이미지와 고정값 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.idCardBirthDateMatch | 신분증 이미지와 생년월일 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.faceImageCustomMatch | 셀피 이미지와 고정값 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.faceImageBirthDateMatch | 셀피 이미지와 생년월일 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.*.result | 개별 비교의 성공/실패 결과 (true: 성공, false: 실패, null: 없을 때) | Boolean | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.*.processed | 해당 비교가 실행되었는지 여부 (true: 성공, false: 실패) | Boolean | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.*.statement | 비교 연산의 구체적인 내용 (예: “36 gte 18”) | String | 얼굴 나이 검증 정보 |
verification.faceAge[i].logicalOperators | 조건식 간 논리 연산자 배열 (and, or) | Array | 얼굴 나이 검증 정보 |
signals | 서브미션 처리 중 생성된 부가 데이터(얼굴 나이, 카메라 프로세스, OCR 신뢰도 등)를 포함하는 객체 | Object | 얼굴 감지 정보 |
signals.confidence | OCR 인식 신뢰도 점수 객체. 각 카테고리별 신뢰도(0.0~1.0). 대시보드 제출건 상세조회 제출정보의 각 항목 신뢰도에 해당. ⭐ NEW | Object | OCR 신뢰도 정보 |
signals.confidence.finalData | 최종 데이터(Argos Score 계산에 사용된 데이터)의 신뢰도 점수 (0.0~1.0) | Object | OCR 신뢰도 정보 |
signals.confidence.ocrData | OCR로 추출된 데이터의 신뢰도 점수 (0.0~1.0) | Object | OCR 신뢰도 정보 |
signals.confidence.ocrExtractedData | OCR 엔진이 원본에서 직접 추출한 데이터의 신뢰도 점수 (0.0~1.0). 한국 주민등록증·운전면허증은 미반환 | Object | OCR 신뢰도 정보 |
signals.faceAge | 얼굴에서 추출된 나이 범위 정보 배열 (매 시도별 누적 기록) | Array | 얼굴 감지 정보 |
signals.faceAge[i].ageRange | 해당 시도에서 감지된 나이 범위 | Object | 얼굴 감지 정보 |
signals.faceAge[i].ageRange.low | 감지된 최저 나이 추정값 | Number | 얼굴 감지 정보 |
signals.faceAge[i].ageRange.high | 감지된 최고 나이 추정값 | Number | 얼굴 감지 정보 |
signals.faceAge[i].ageRange.median | 감지된 중간 나이 추정값 | Number | 얼굴 감지 정보 |
signals.faceAge[i].source | 나이 추정 소스 이미지 유형 (selfieImage, idImage) | String | 얼굴 감지 정보 |
signals.startButtonClickTime | 사용자가 시작 버튼을 클릭한 시각 (ISO 8601 형식) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo | 카메라 동작 데이터 배열 | Array | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].type | 프로세스 타입 (예: idcard-front-capture, id-document-face-passive, 등) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].processStartTime | 해당 프로세스가 시작된 시각 (ISO 8601 형식) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].processEndTime | 해당 프로세스가 종료된 시각 (ISO 8601 형식) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].error | 해당 프로세스 중 발생한 에러 (null이면 에러 없음) | String | 카메라 프로세스 정보 |
updateHistory | 마지막으로 제출 정보가 업데이트된 기록 | Object | 대시보드 정보 |
updateHistory.updateAdmin | 마지막으로 제출 정보를 업데이트한 admin의 이메일 | String | 대시보드 정보 |
updateHistory.updateTime | 마지막으로 제출 정보를 업데이트한 시각 | String | 대시보드 정보 |
warning | 경고 정보를 포함하는 배열 (ID Document에만 적용) | Array | 경고 정보 |
warning[i].userDataType | 입력 데이터 유형 | String | 경고 정보 |
warning[i].relatedEngine | 경고가 발생한 엔진 | String | 경고 정보 |
warning[i].occurrenceTime | 경고 발생 시각 | String | 경고 정보 |
kyc.retry | KYC 처리 중 재시도 조건을 일으킨 재시도 정보를 포함하는 배열 | Array | KYC 재시도 정보 |
kyc.retry[i].type | 재시도를 일으킨 단계 유형 (step1, step2) | String | KYC 재시도 정보 |
kyc.retry[i].retryCnt | 해당 재시도 조건에 대한 재시도 횟수 | Number | KYC 재시도 정보 |
kyc.retry[i].retryCode | 발생한 특정 재시도 조건을 식별하는 코드 | String | KYC 재시도 정보 |
kyc.retry[i].retryMessage | 재시도 조건을 설명하고 권장 조치를 제공하는 상세 메시지 | String | KYC 재시도 정보 |
aml | AML 스크리닝 결과를 포함하는 객체 | Object | AML 스크리닝 정보 |
aml.raw_data | AML 스크리닝의 원시 데이터 | Object | AML 스크리닝 정보 |
aml.risk_level_summary | 리스크 수준 요약 (Not Screened, High, Medium, Low) Risk Level | Enum | AML 스크리닝 정보 |
aml.currentstatus | AML 스크리닝의 현재 상태 (Not Screened, Red Flag) AML Screening Status | Enum | AML 스크리닝 정보 |
aml.matches | AML 스크리닝의 상세 매칭 결과 | Array | AML 스크리닝 정보 |
aml.matches[i].risk_level | 레드 플래그 위험 수준 (HIGH, MEDIUM, LOW) AML Screening Info | Enum | AML 스크리닝 정보 |
aml.matches[i].argos_number | AML 보고서를 조회하기 위한 고유 ID | String | AML 스크리닝 정보 |
aml.matches[i].resource_id | AML 보고서를 조회하기 위한 리소스 고유 ID | String | AML 스크리닝 정보 |
aml.matches[i].score | AML 스크리닝 매칭 점수 | Float | AML 스크리닝 정보 |
aml.matches[i].risk_icons | AML 스크리닝 위험 아이콘 | Array | AML 스크리닝 정보 |
nextpageKey | 추가 페이지를 호출할 때 필요한 키 | Object | 페이지 네비게이션 정보 |
nextpageKey.id | 마지막으로 조회된 제출 ID | String | 페이지 네비게이션 정보 |
nextpageKey.created_at | 마지막으로 조회된 제출의 생성 시간 | String | 페이지 네비게이션 정보 |
bank_verification | 계좌 인증 결과를 포함하는 객체 | Object | 계좌 인증 정보 |
bank_verification.result | 계좌 인증 결과 (success, fail) | Enum | 계좌 인증 정보 |
bank_verification.type | 계좌 인증 유형 (occupancy(1원 인증), nameCheck) | Enum | 계좌 인증 정보 |
bank_verification.bank_code | 계좌 인증에 사용된 은행 코드 | String | 계좌 인증 정보 |
bank_verification.account_number | 계좌 인증에 사용된 계좌 번호 | String | 계좌 인증 정보 |
bank_verification.retry_count | 코드 전송 실패 횟수 (pre-step2) | Number | 계좌 인증 정보 |
id_LivenessScore | ID 카드 생체 인증 점수 데이터를 포함하는 객체 | Object | 생체 인증 점수 정보 |
id_LivenessScore.Screen_play | Screen play 파이프라인의 생체 인증 점수 | Float | 생체 인증 점수 정보 |
id_LivenessScore.Paper_printed | Paper printed 파이프라인의 생체 인증 점수 | Float | 생체 인증 점수 정보 |
id_LivenessScore.Replace_portraits | Replace portraits 파이프라인의 생체 인증 점수 | Float | 생체 인증 점수 정보 |
Injection_action | Injection 프로세스 실행 내역을 포함하는 객체 | Object | Injection 프로세스 정보 |
Injection_action.type | Injection 프로세스 유형 | String | Injection 프로세스 정보 |
Injection_action.time | Injection 프로세스 유형별 최근 실행 시간 | String | Injection 프로세스 정보 |
projection | 해당 서브미션에 적용된 Projection 정보를 포함하는 객체 | Object | Projection Info |
projection.projectionId | 해당 제출건에 적용된 Projection의 ID | String | Projection Info |
projection.projectionName | 해당 제출건에 적용된 Projection의 이름 | String | Projection Info |
tokenId | Private mode에서 제출 시 사용된 Token ID | String | 제출 정보 |
pre_verification | pre_verification 객체 목록 | object | pre_verification 정보 |
pre_verification.request_id | pre_verification의 요청 ID | String | pre_verification 정보 |
pre_verification.created_at | 요청 타임스탬프 | String | pre_verification 정보 |
pre_verification.ip_address | 요청 IP 주소 | String | pre_verification 정보 |
pre_verification.fraud_score | 사기 점수 | Number | pre_verification 정보 |
pre_verification.attempts_frequency | 서브넷 시도 빈도: [0=‘FirstSeen’, 1 | String | pre_verification 정보 |
pre_verification.country_code | 요청된 IP 주소의 국가 코드 | String | pre_verification 정보 |
pre_verification.connection_type | 연결 유형: [‘Residential’, ‘Corporate’, ‘Education’, ‘Mobile’, ‘DataCenter’] | String | pre_verification 정보 |
pre_verification.is_valid | pre_verification이 실패인지 통과인지의 상태 | Boolean | pre_verification 정보 |
Signals Object 및 Confidence
서브미션 처리 중 생성된 부가 데이터는signals 하위에서 응답합니다.
Confidence Object (signals.confidence) ⭐ NEW
OCR 인식 신뢰도 점수를 제공하는 객체입니다. 각 카테고리별로 신뢰도 점수(0.0 ~ 1.0)를 포함합니다. 대시보드 제출건 상세조회 제출정보의 각 항목 신뢰도에 해당하는 값입니다.
signals.confidence.finalData
최종 데이터(Argos Score 계산에 사용된 데이터)의 신뢰도 점수입니다.
| 필드 | 타입 | 설명 |
|---|---|---|
fullName | number | 전체 이름 신뢰도 (0.0 ~ 1.0) |
firstName | number | 이름 신뢰도 (0.0 ~ 1.0) |
lastName | number | 성 신뢰도 (0.0 ~ 1.0) |
gender | number | 성별 신뢰도 (0.0 ~ 1.0) |
nationality | number | 국적 신뢰도 (0.0 ~ 1.0) |
birthDate | number | 생년월일 신뢰도 (0.0 ~ 1.0) |
identityNumber | number | 주민등록번호 신뢰도 (0.0 ~ 1.0) |
issueDate | number | 발급일 신뢰도 (0.0 ~ 1.0) |
expireDate | number | 만료일 신뢰도 (0.0 ~ 1.0) |
licenseNumber | number | 면허번호 신뢰도 (0.0 ~ 1.0) |
documentNumber | number | 문서번호 신뢰도 (0.0 ~ 1.0) |
serialNumber | number | 시리얼 번호 신뢰도 (0.0 ~ 1.0) |
curpNumber | number | CURP 번호 신뢰도 (0.0 ~ 1.0) |
typeOfPermit | number | 허가 유형 신뢰도 (0.0 ~ 1.0) |
signals.confidence.ocrData
OCR로 추출된 데이터의 신뢰도 점수입니다.
| 필드 | 타입 | 설명 |
|---|---|---|
fullName | number | 전체 이름 OCR 신뢰도 (0.0 ~ 1.0) |
birthDate | number | 생년월일 OCR 신뢰도 (0.0 ~ 1.0) |
expireDate | number | 만료일 OCR 신뢰도 (0.0 ~ 1.0) |
issueDate | number | 발급일 OCR 신뢰도 (0.0 ~ 1.0) |
gender | number | 성별 OCR 신뢰도 (0.0 ~ 1.0) |
nationality | number | 국적 OCR 신뢰도 (0.0 ~ 1.0) |
documentNumber | number | 문서번호 OCR 신뢰도 (0.0 ~ 1.0) |
identityNumber | number | 주민등록번호 OCR 신뢰도 (0.0 ~ 1.0) |
licenseNumber | number | 면허번호 OCR 신뢰도 (0.0 ~ 1.0) |
serialNumber | number | 시리얼 번호 OCR 신뢰도 (0.0 ~ 1.0) |
curpNumber | number | CURP 번호 OCR 신뢰도 (0.0 ~ 1.0) |
version | number | 버전 OCR 신뢰도 (0.0 ~ 1.0) |
typeOfPermit | number | 허가 유형 OCR 신뢰도 (0.0 ~ 1.0) |
signals.confidence.ocrExtractedData
OCR 엔진이 원본에서 직접 추출한 데이터의 신뢰도 점수입니다.
| 필드 | 타입 | 설명 |
|---|---|---|
rotate | number | 회전 각도 신뢰도 (0.0 ~ 1.0) |
birth_date | number | 생년월일 신뢰도 (0.0 ~ 1.0) |
date_of_birth | number | 생년월일 신뢰도 (0.0 ~ 1.0) |
emergency_name | number | 비상연락처 이름 신뢰도 (0.0 ~ 1.0) |
number | number | 문서번호 신뢰도 (0.0 ~ 1.0) |
height | number | 키 신뢰도 (0.0 ~ 1.0) |
restrictions | number | 제한사항 신뢰도 (0.0 ~ 1.0) |
weight | number | 몸무게 신뢰도 (0.0 ~ 1.0) |
emergency_address | number | 비상연락처 주소 신뢰도 (0.0 ~ 1.0) |
nationality | number | 국적 신뢰도 (0.0 ~ 1.0) |
authority | number | 발급기관 신뢰도 (0.0 ~ 1.0) |
name | number | 이름 신뢰도 (0.0 ~ 1.0) |
gender | number | 성별 신뢰도 (0.0 ~ 1.0) |
audit_number | number | 감사 번호 신뢰도 (0.0 ~ 1.0) |
emergency_telephone | number | 비상연락처 전화번호 신뢰도 (0.0 ~ 1.0) |
eyes | number | 눈 색상 신뢰도 (0.0 ~ 1.0) |
donor | number | 기증자 여부 신뢰도 (0.0 ~ 1.0) |
blood_type | number | 혈액형 신뢰도 (0.0 ~ 1.0) |
first_name | number | 이름 신뢰도 (0.0 ~ 1.0) |
address | number | 주소 신뢰도 (0.0 ~ 1.0) |
expiry_date | number | 만료일 신뢰도 (0.0 ~ 1.0) |
last_name | number | 성 신뢰도 (0.0 ~ 1.0) |
middle_name | number | 중간 이름 신뢰도 (0.0 ~ 1.0) |
endorsements | number | 승인 사항 신뢰도 (0.0 ~ 1.0) |
id_number | number | 신분증 번호 신뢰도 (0.0 ~ 1.0) |
serial_number | number | 시리얼 번호 신뢰도 (0.0 ~ 1.0) |
curp_number | number | CURP 번호 신뢰도 (0.0 ~ 1.0) |
version | number | 버전 신뢰도 (0.0 ~ 1.0) |
type_of_permit | number | 허가 유형 신뢰도 (0.0 ~ 1.0) |
issue_date | number | 발급일 신뢰도 (0.0 ~ 1.0) |
birth_date_eng, birth_date_{country} | number | 국가별 생년월일 신뢰도 (0.0 ~ 1.0) |
expiry_date_eng, expiry_date_{country} | number | 국가별 만료일 신뢰도 (0.0 ~ 1.0) |
issue_date_eng, issue_date_{country} | number | 국가별 발급일 신뢰도 (0.0 ~ 1.0) |
gender_eng, gender_{country} | number | 국가별 성별 신뢰도 (0.0 ~ 1.0) |
nationality_eng, nationality_{country} | number | 국가별 국적 신뢰도 (0.0 ~ 1.0) |
mrz_birth_date, mrz_expiry_date, mrz_issue_date, mrz_gender, mrz_nationality | number | MRZ 필드 신뢰도 (0.0 ~ 1.0) |
- 모든 confidence 값은 0.0 ~ 1.0 범위의 숫자입니다.
- 필드는 데이터 존재 여부와 confidence 값에 따라 조건부로 포함됩니다.
응답 데이터 (Knowledge-based)
| Field Name | Description | Data Type | Category |
|---|---|---|---|
data | KYC 제출자 데이터 | Object | KYC 제출자 정보 |
data.name | 제출자의 이름 | String | KYC 제출자 정보 |
data.gender | 제출자의 성별 (male 또는 female) | Enum | KYC 제출자 정보 |
data.nationality | ISO alpha-3 형식의 국가 코드 | String | KYC 제출자 정보 |
data.date_of_birth | 제출자의 생년월일 (YYYY-MM-DD 형식) | Date | KYC 제출자 정보 |
data.address_formatted | 변환된 상세 주소 | String | KYC 제출자 정보 |
data.address_detail | 사용자가 입력한 상세 주소 | String | KYC 제출자 정보 |
data.ssnNumber | 소셜 시큐리티 넘버 | String | KYC Applicant Info |
data.phoneNumber | 전화번호 | String | KYC Applicant Info |
data.cf1 | 사용자 정의 필드 #1 | String | KYC 제출자 정보 |
data.cf2 | 사용자 정의 필드 #2 | String | KYC 제출자 정보 |
data.cf3 | 사용자 정의 필드 #3 | String | KYC 제출자 정보 |
email | 제출과 연관된 이메일 주소 | String | KYC 제출자 정보 |
reviewer | 검수 유형: system은 AI 시스템 검수, agent는 사람 검수를 나타냄 | Enum | KYC 검수 정보 |
submission_id | 각 제출 건에 부여된 고유 식별자 | String | 제출 정보 |
duplicated_information | 이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.) | String | 제출 정보 |
created_at | 제출된 날짜와 시간 (UTC+0) | String | 제출 정보 |
kyc_result_at | KYC 결과가 최종적으로 결정된 날짜와 시간 | String | 제출 정보 |
updated_at | 마지막으로 제출 정보가 업데이트된 날짜와 시간 | String | 제출 정보 |
pending_at | KYC가 보류(Pending) 상태로 표시된 날짜와 시간 | String | 제출 정보 |
userid | 제출 생성 시 선택적으로 추가된 파라미터 | String | 제출 정보 |
additional_list | 대시보드에서 설정된 추가 양식에 대해 사용자가 입력한 데이터 | Array | 추가 양식 정보 |
additional_list.answer | 각 추가 양식 필드의 이름 | String | 추가 양식 정보 |
additional_list.inputValue | 각 필드에 대한 사용자 입력 값 | String | 추가 양식 정보 |
additional_list.blockType | 각 추가 양식 필드의 데이터 타입 | String | 추가 양식 정보 |
verification | 얼굴 기반 나이 검증 결과를 포함하는 객체 | Object | 얼굴 나이 검증 정보 |
verification.faceAge | 얼굴 기반 나이 검증의 전체 결과 배열 (매 시도별 누적 기록) | Array | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues | 검증에 사용된 나이 값들 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalSelfieLow | LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalSelfieHigh | LOW/HIGH 확장 설정 적용 전 셀피 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalSelfieMedian | LOW/HIGH 확장 설정 적용 전 셀피 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalIdLow | LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalIdHigh | LOW/HIGH 확장 설정 적용 전 신분증 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.originalIdMedian | LOW/HIGH 확장 설정 적용 전 신분증 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.selfieLow | LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.selfieHigh | LOW/HIGH 확장 설정 적용 후 셀피 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.selfieMedian | LOW/HIGH 확장 설정 적용 후 셀피 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.idLow | LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최저 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.idHigh | LOW/HIGH 확장 설정 적용 후 신분증 이미지의 최고 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.idMedian | LOW/HIGH 확장 설정 적용 후 신분증 이미지의 중간 나이 추정값 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].usedValues.birthDateAge | 사용자 입력 생년월일로 계산한 만 나이 | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults | 각 조건식별 검증 결과 배열 | Array | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].condition | 조건식 설정 정보 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].condition.comparisonOperator | 비교 연산자 (gte: 이상, gt: 초과, lte: 이하, lt: 미만) | String | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].condition.target | 비교 대상 나이 유형 (low, high, median) | String | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].conditionIndex | 조건식 인덱스 (0부터 시작) | Number | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].finalResult | 해당 조건식의 최종 검증 결과 (true: 성공, false: 실패) | Boolean | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults | 각 타겟 이미지와 기준 나이 조합별 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.idCardCustomMatch | 신분증 이미지와 고정값 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.idCardBirthDateMatch | 신분증 이미지와 생년월일 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.faceImageCustomMatch | 셀피 이미지와 고정값 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.faceImageBirthDateMatch | 셀피 이미지와 생년월일 나이 비교 결과 | Object | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.*.result | 개별 비교의 성공/실패 결과 (true: 성공, false: 실패, null: 없을 때) | Boolean | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.*.processed | 해당 비교가 실행되었는지 여부 (true: 성공, false: 실패) | Boolean | 얼굴 나이 검증 정보 |
verification.faceAge[i].conditionResults[j].matchResults.*.statement | 비교 연산의 구체적인 내용 (예: “36 gte 18”) | String | 얼굴 나이 검증 정보 |
verification.faceAge[i].logicalOperators | 조건식 간 논리 연산자 배열 (and, or) | Array | 얼굴 나이 검증 정보 |
signals | 서브미션 처리 중 생성된 부가 데이터(얼굴 나이, 카메라 프로세스, OCR 신뢰도 등)를 포함하는 객체 | Object | 얼굴 감지 정보 |
signals.confidence | OCR 인식 신뢰도 점수 객체. 각 카테고리별 신뢰도(0.0~1.0). 대시보드 제출건 상세조회 제출정보의 각 항목 신뢰도에 해당. ⭐ NEW | Object | OCR 신뢰도 정보 |
signals.faceAge | 얼굴에서 추출된 나이 범위 정보 배열 (매 시도별 누적 기록) | Array | 얼굴 감지 정보 |
signals.faceAge[i].ageRange | 해당 시도에서 감지된 나이 범위 | Object | 얼굴 감지 정보 |
signals.faceAge[i].ageRange.low | 감지된 최저 나이 추정값 | Number | 얼굴 감지 정보 |
signals.faceAge[i].ageRange.high | 감지된 최고 나이 추정값 | Number | 얼굴 감지 정보 |
signals.faceAge[i].ageRange.median | 감지된 중간 나이 추정값 | Number | 얼굴 감지 정보 |
signals.faceAge[i].source | 나이 추정 소스 이미지 유형 (selfieImage, idImage) | String | 얼굴 감지 정보 |
signals.startButtonClickTime | 사용자가 시작 버튼을 클릭한 시각 (ISO 8601 형식) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo | 카메라 동작 데이터 배열 | Array | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].type | 프로세스 타입 (예: knowledge-face-passive, knowledge-face-active, 등) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].processStartTime | 해당 프로세스가 시작된 시각 (ISO 8601 형식) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].processEndTime | 해당 프로세스가 종료된 시각 (ISO 8601 형식) | String | 카메라 프로세스 정보 |
signals.cameraProcessInfo[i].error | 해당 프로세스 중 발생한 에러 (null이면 에러 없음) | String | 카메라 프로세스 정보 |
kyc | KYC 결과를 포함하는 객체 KYC 상태 | Object | KYC 결과 정보 |
kyc.result | KYC 프로세스의 상태 | Enum | KYC 결과 정보 |
kyc.comment | KYC 거절 사유 [거절 코드 및 사유]/ko/idcheck/api-reference/api-reference-guide/reject-codes-and-comments) | String | KYC 결과 정보 |
kyc.commentCode | KYC 거절 사유를 나타내는 코드 거절 코드 및 사유 | String | KYC 결과 정보 |
kyc.attempts[i].attemptCnt | 실패 후 재시도한 횟수 | Number | KYC 시도 정보 |
kyc.attempts[i].errorCode | 얼굴 인식, 비교 확인 중 발생한 오류 코드 | String | KYC 시도 정보 |
kyc.attempts[i].errorMsg | 얼굴 인식, 비교 확인 중 발생한 오류 메시지 | String | KYC 시도 정보 |
kyc.attempts[i].step1Time1st | step1 첫 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step1Time2nd | step1 두 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step1Time3rd | step1 세 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step2Time1st | step2 첫 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step2Time2nd | step2 두 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].step2Time3rd | step2 세 번째 호출 시간 | String | KYC 시도 정보 |
kyc.attempts[i].retryMsg | 얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 메시지 | String | KYC 시도 정보 |
kyc.attempts[i].retryCode | 얼굴 인식, 비교, 신분증 진위 확인 중 발생한 실패 코드 | String | KYC 시도 정보 |
kyc.attempts[i].faceSimilarityScore | 얼굴 비교 유사도 점수 | Float | KYC 시도 정보 |
kyc.attempts[i].selfieImage | 제출된 셀피 이미지의 URL | String | KYC 시도 정보 |
kyc.attempts[i].livenessScore | 시도의 생체 인증 점수 | Float | KYC 시도 정보 |
kyc.attempts[i].liveness | 생체 인증 점수의 상세 데이터 (score, probability, quality 포함) | Object | KYC 시도 정보 |
kyc.attempts[i].liveness.score | 생체 인증의 전체 점수 | Float | KYC 시도 정보 |
kyc.attempts[i].liveness.probability | 생체 인증의 확률 값 | Float | KYC 시도 정보 |
kyc.attempts[i].liveness.quality | 생체 인증의 품질 점수 | Float | KYC 시도 정보 |
kyc.attempts[i].detectFace | 얼굴 감지 결과를 포함하는 배열 (AWS Rekognition DetectFaces API 응답) | Array | 얼굴 감지 정보 |
kyc.attempts[i].detectFace.AgeRange | 감지된 얼굴의 나이 범위 정보 | Object | 얼굴 감지 정보 |
kyc.attempts[i].detectFace.AgeRange.High | 감지된 얼굴의 최고 나이 추정값 | Number | 얼굴 감지 정보 |
kyc.attempts[i].detectFace.AgeRange.Low | 감지된 얼굴의 최저 나이 추정값 | Number | 얼굴 감지 정보 |
kyc.attempts[i].detectFace.Gender.Confidence | 성별 판정의 신뢰도 (0~100) | Float | 얼굴 감지 정보 |
kyc.attempts[i].detectFace.Gender.Value | 감지된 성별 (Male, Female) | String | 얼굴 감지 정보 |
verification | 얼굴 기반 나이 검증 결과를 포함하는 객체 | Object | 얼굴 나이 검증 정보 |
aml | AML 스크리닝 결과를 포함하는 객체 | Object | AML 스크리닝 정보 |
aml.raw_data | AML 스크리닝의 원시 데이터 | Object | AML 스크리닝 정보 |
aml.risk_level_summary | 리스크 수준 요약 (Not Screened, High, Medium, Low) Risk Level | Enum | AML 스크리닝 정보 |
aml.currentstatus | AML 스크리닝의 현재 상태 (Not Screened, Red Flag) AML Screening Status | Enum | AML 스크리닝 정보 |
aml.matches | AML 스크리닝의 상세 매칭 결과 | Array | AML 스크리닝 정보 |
aml.matches[i].risk_level | 레드 플래그 위험 수준 (HIGH, MEDIUM, LOW) AML Screening Info | Enum | AML 스크리닝 정보 |
aml.matches[i].argos_number | AML 보고서를 조회하기 위한 고유 ID | String | AML 스크리닝 정보 |
aml.matches[i].resource_id | AML 보고서를 조회하기 위한 리소스 고유 ID | String | AML 스크리닝 정보 |
aml.matches[i].score | AML 스크리닝 매칭 점수 | Float | AML 스크리닝 정보 |
aml.matches[i].risk_icons | AML 스크리닝 위험 아이콘 | Array | AML 스크리닝 정보 |
nextpageKey | 추가 페이지를 호출할 때 필요한 키 | Object | 페이지 네비게이션 정보 |
nextpageKey.id | 마지막으로 조회된 제출 ID | String | 페이지 네비게이션 정보 |
nextpageKey.created_at | 마지막으로 조회된 제출의 생성 시간 | String | 페이지 네비게이션 정보 |
projection | 해당 서브미션에 적용된 Projection 정보를 포함하는 객체 | Object | Projection Info |
projection.projectionId | 해당 제출건에 적용된 Projection의 ID | String | Projection Info |
projection.projectionName | 해당 제출건에 적용된 Projection의 이름 | String | Projection Info |
tokenId | Private mode에서 제출 시 사용된 Token ID | String | 제출 정보 |
pre_verification | pre_verification 객체 목록 | object | pre_verification 정보 |
pre_verification.request_id | pre_verification의 요청 ID | String | pre_verification 정보 |
pre_verification.created_at | 요청 타임스탬프 | String | pre_verification 정보 |
pre_verification.ip_address | 요청 IP 주소 | String | pre_verification 정보 |
pre_verification.fraud_score | 사기 점수 | Number | pre_verification 정보 |
pre_verification.attempts_frequency | 서브넷 시도 빈도: [0=‘FirstSeen’, 1 | String | pre_verification 정보 |
pre_verification.country_code | 요청된 IP 주소의 국가 코드 | String | pre_verification 정보 |
pre_verification.connection_type | 연결 유형: [‘Residential’, ‘Corporate’, ‘Education’, ‘Mobile’, ‘DataCenter’] | String | pre_verification 정보 |
pre_verification.is_valid | pre_verification이 실패인지 통과인지의 상태 | Boolean | pre_verification 정보 |
카메라 프로세스 타입 상세
프로세스 과정에서 생성된 부가 데이터는signals 하위에서 응답합니다. signals.cameraProcessInfo 배열의 type 필드는 각 프로세스 단계에서 사용자가 어떤 방식으로 이미지를 제출했는지를 나타냅니다.
1. 신분증 처리 프로세스
1. 신분증 처리 프로세스
신분증 이미지를 획득하는 방식을 정의하는 프로세스 타입입니다.
1.1 신분증 앞면 (ProcessIdCardFront)
신분증 앞면 이미지를 획득하는 방식을 정의합니다.| 타입 | 설명 |
|---|---|
idcard-front-upload | 파일 업로드 방식 - 사용자가 기기에 저장된 신분증 앞면 이미지 파일을 직접 선택하여 업로드 |
idcard-front-capture | 캡처 방식 - 카메라를 통해 실시간으로 신분증 앞면을 촬영하며, 사용자가 직접 촬영 타이밍을 제어 |
idcard-front-autocapture | 자동 캡처 방식 - 카메라를 통해 신분증을 인식하면 자동으로 촬영하며, 신분증 위치, 각도, 초점 등의 조건이 충족되면 자동 촬영 |
1.2 신분증 뒷면 (ProcessIdCardBack)
신분증 뒷면 이미지를 획득하는 방식을 정의합니다.| 타입 | 설명 |
|---|---|
idcard-back-upload | 파일 업로드 방식 - 사용자가 기기에 저장된 신분증 뒷면 이미지 파일을 직접 선택하여 업로드 |
idcard-back-capture | 캡처 방식 - 카메라를 통해 실시간으로 신분증 뒷면을 촬영하며, 사용자가 직접 촬영 타이밍을 제어 |
idcard-back-autocapture | 자동 캡처 방식 - 카메라를 통해 신분증을 인식하면 자동으로 촬영하며, 신분증 위치, 각도, 초점 등의 조건이 충족되면 자동 촬영 |
2. 얼굴 인증 프로세스
2. 얼굴 인증 프로세스
얼굴 이미지를 획득하여 인증하는 방식을 정의하는 프로세스 타입입니다.
2.1 신분증 기반 얼굴 인증 (IdDocumentFace)
신분증에 등록된 얼굴과 비교하기 위한 얼굴 이미지를 획득하는 방식을 정의합니다.| 타입 | 설명 |
|---|---|
id-document-face-passive | 패시브 방식 - 카메라를 통해 자연스러운 상태의 얼굴을 촬영하며, 별도의 동작이나 표정 변화 없이 정면 얼굴만 촬영 |
id-document-face-active | 액티브 방식 - 카메라를 통해 특정 동작을 수행하는 얼굴을 촬영 |
2.2 Knowledge 얼굴 인증 (KnowledgeFace)
기존에 등록된 얼굴 정보와 비교하기 위한 얼굴 이미지를 획득하는 방식을 정의합니다.| 타입 | 설명 |
|---|---|
knowledge-face-passive | 패시브 방식 - 카메라를 통해 자연스러운 상태의 얼굴을 촬영 |
knowledge-face-active | 액티브 방식 - 카메라를 통해 특정 동작을 수행하는 얼굴을 촬영 |
signals.cameraProcessInfo 배열에는 사용자가 제출 과정에서 거친 모든 프로세스 단계가 순차적으로 기록됩니다. 각 프로세스의 시작 시간, 종료 시간, 에러 정보를 통해 사용자의 제출 과정을 추적할 수 있습니다.