본 메소드는 다수의 목록을 가져옵니다. 하지만, 단일 건에서만 보이는 field들에 대한 정의가 내려져 있습니다.
다수 건 목록 시, 빠져있는 field들에 대해선, 단일 건 조회로 확인할 수 있습니다.
단일 건만 가저오는 메소드 호출 방법은 여기를 참조해주세요.
1. 엔드포인트
GET/Submission
2. 인증
x-api-key
헤더에 API 키를 포함시켜야 합니다:
x-api-key
3. 요청 파라미터
요청 파라미터는 URL query 형식이어야 합니다. 각 파라미터에 대한 설명은 다음과 같습니다.특정 제출 건의 고유 ID; (단일 건 조회)
사용자 ID와 일치하는 목록 조회
이메일 주소와 일치하는 제출 목록 조회
반환할 결과의 수 (기본값: 50)
다음 페이지 조회를 위한 ID
다음 페이지 조회를 위한 날짜
조회 시작 날짜 (YYYY-MM-DD)
조회 종료 날짜 (YYYY-MM-DD)
request_type 파라미터를 사용하여 특정 데이터 유형만 선택적으로 조회할 수 있습니다. 다음 옵션 중 하나를 선택하여 입력할 수 있습니다:
kyc
: KYC 관련 데이터와 submission_id를 반환합니다.aml
: AML 관련 데이터와 submission_id를 반환합니다.data
: 제출자의 개인 정보 데이터와 submission_id를 반환합니다.others
: KYC, AML, 개인 정보를 제외한 나머지 모든 데이터 항목을 반환합니다.
4. 요청 예시
POST/Submission
5. 응답
5-1. 성공 응답
5-2-a. 응답 데이터 (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_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 제출자 정보 |
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 제출자 정보 |
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 | 제출 정보 |
applicant_id | 중복 제출된 사용자에 부여된 식별자 | 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 | 추가 양식 정보 |
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].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 | 얼굴에서 추출된 원시 데이터를 포함하는 객체 | Object | 얼굴 감지 정보 |
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 | 얼굴 감지 정보 |
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 정보 |
5-2-b. 응답 데이터 (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 | 얼굴에서 추출된 원시 데이터를 포함하는 객체 | Object | 얼굴 감지 정보 |
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 | 얼굴 감지 정보 |
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].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 정보 |
5-3. 오류 코드
에러 코드 | 메시지 | 설명 |
---|---|---|
invalid_payload | Invalid payload | 요청 본문을 파싱할 수 없음 |
missing_data | Required input data is missing | 필수 필드가 누락됨 |
invalid_project | Invalid project | 프로젝트 ID가 유효하지 않음 |
invalid_admin | Invalid admin | 관리자 계정에 이 프로젝트에 대한 권한이 없음 |
invalid_parameter | invalid parameter: {parameter} | 예상치 못한 매개변수가 제출됨 |
invalid_format | invalid format: ${parameter} | 매개변수가 예상 형식과 일치하지 않음 |
processing_error | Failed to complete migration | 처리 중 알 수 없는 오류 발생 |
6. 암호화 옵션
사전 요구 사항 : 안전한 암호화 옵션을 활성화해야 합니다. 암호화 적용 전에 가이드를 먼저 확인해주세요.
body
매개변수로 전송합니다.
6-1. 암호화된 요청 예시
encrypt-available-params.json
data
파라메터로 위 암호화된 값을 입력 후 호출합니다.
6-2. 암호화된 응답
응답에는 isEncrypted 플래그와 암호화된 데이터가 포함됩니다:result.json