공유 세션 가져오기 API: 재사용 가능한 KYC 및 KYB

이 세션에 구성된 인증 기능 목록이며, 표시 이름으로 제공됩니다: ID_VERIFICATION, NFC, LIVENESS, FACE_MATCH, POA, PHONE, EMAIL_VERIFICATION, AML, IP_ANALYSIS, DATABASE_VALIDATION, QUESTIONNAIRE, AGE_ESTIMATION, FACE_SEARCH, GEOLOCATION(위치 확인) (기업 확인(KYB) 세션은 KYB 기능 세트를 사용합니다: KYB_REGISTRY, KYB_DOCUMENTS, KYB_KEY_PEOPLE, AML, PHONE, EMAIL_VERIFICATION, IP_ANALYSIS, QUESTIONNAIRE). include=events를 사용하면 각 항목이 일반 문자열 대신 {feature, node_id} 객체가 되며, 이메일 기능의 이름이 변경됩니다. 여기에서 사용된 EMAIL_VERIFICATION 대신 이벤트 모드에서는 EMAIL로 표시됩니다.

워크플로 그래프의 신분증 문서 단계에서 생성된 신분증 인증(OCR) 보고서 배열입니다. 항상 JSON 배열입니다. 워크플로에서 둘 이상의 신분증 확인(예: 기본 확인에 추가적인 스텝업 확인)을 실행할 수 있는 경우 id_verifications[0]을 읽고 반복 처리하십시오. 하나 이상의 신분증 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, 추출된 문서 필드, 이미지 URL, 품질 점수, MRZ, 주소 파싱, 세션 간 일치 항목, warnings[]를 포함한 전체 보고서입니다.

워크플로 그래프의 NFC 단계에서 생성된 NFC / 전자여권 보고서 배열입니다. 단일 nfc 객체가 아닌 항상 JSON 배열입니다 — 워크플로에서 NFC를 두 번 이상 실행할 수 있는 경우 nfc_verifications[0]을 읽고 반복 처리하십시오. 하나 이상의 NFC 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, chip_protocol, chip_data, authenticity(SOD + DG 무결성), certificate_summary, warnings[]를 포함한 전체 보고서입니다. 일본 마이넘버카드는 ICAO 9303 대신 JPKI를 통해 읽힙니다. 해당 항목은 chip_protocol: "jpki"를 가지며 증거를 jpki 아래에 포함하고 ICAO 필드는 null로 유지합니다. NFC 단계를 제시할 수 있기 전에 건너뛴 경우(칩이 없는 문서, 인증서 누락, 보고된 NFC 기능 없음, 읽을 수 없는 MRZ 키, 마이넘버카드에 JPKI를 사용할 수 없음) 이 필드는 null로 유지되며 nfc_skip_reason에 이유가 설명됩니다. 단계 자체에서 건너뛴 경우(사용자가 건너뛰기를 탭했거나 스캔 시점에 리더기를 사용할 수 없는 것으로 나타남)에는 is_nfc_skipped: true인 보고서가 생성됩니다.

워크플로 그래프의 라이브니스 단계에서 생성된 라이브니스 보고서 배열입니다. 단일 liveness 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 라이브니스 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, method, score, reference_image, video_url, 선택 사항인 age_estimation, 세션 간 matches[], warnings[]를 포함한 전체 보고서입니다.

워크플로 그래프의 얼굴 대조 단계에서 생성된 얼굴 대조 보고서 배열입니다. 단일 face_match 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 얼굴 대조 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, 유사도 score, source_image, target_image, warnings[]를 포함한 전체 보고서입니다.

전화번호 인증 보고서 배열 — 단일 phone 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 전화번호 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, 전화번호 및 국가 메타데이터, lifecycle[], matches[], warnings[]를 포함한 전체 보고서입니다.

이메일 인증 보고서 배열 — 단일 email 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 이메일 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, 이메일 주소, 유출 데이터, lifecycle[], matches[], warnings[]를 포함한 전체 보고서입니다.

주소 증명(POA) 보고서 배열 — 단일 poa 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 POA 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, 문서 파일 URL, 발급자, 날짜, 파싱된 주소, warnings[]를 포함한 전체 보고서입니다.

워크플로 노드별로 그룹화된 Document AI 보고서 — 항상 JSON 배열이며 단일 객체가 아닙니다. 최소 하나의 Document AI 단계에서 데이터가 생성될 때까지 null입니다. session_kind = user일 때만 표시됩니다. 각 항목은 집계된 status, node_id, 문서별 결과(구성된 필드 키를 키로 하는 추출된 데이터)의 items[] 배열, 그리고 warnings를 포함하는 노드 그룹입니다.

설문지 응답 보고서 배열 — 단일 questionnaire 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 설문지 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 설문지 메타데이터, 양식 요소가 포함된 섹션, 사용자의 답변을 포함한 전체 보고서입니다.

사용자 인증 및 기업 확인(KYB)에 대한 은행 인증 단계별 한 항목씩의 은행 인증 결과입니다. 단계에서 결과가 생성될 때까지 null입니다. 각 항목의 method는 계좌가 어떻게 인증되었는지를 나타냅니다: open_banking(은행 로그인) 또는 account_lookup(계좌 조회), 또는 statement나 microdeposits 대체 수단, 그리고 시도가 평가되기 전에 사용자가 은행 없이 계속 진행한 경우(continued_without_bank) none입니다. 은행 인증 방법을 참조하십시오.

사용자 인증 및 기업 확인(KYB)에 대한 서명자 및 서명 단계별 전자 서명 결과 항목입니다. 워크플로에 전자 서명 단계가 있는 경우에만 표시되며, 서명자가 해당 단계에 도달할 때까지는 빈 배열입니다. 전자 서명 보고서를 참조하세요.

AML 스크리닝 보고서 배열 — 단일 aml 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 AML 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, total_hits, entity_type, hits[], score, screened_data, is_ongoing_monitoring_enabled 및 warnings[]를 포함한 전체 보고서입니다.

기기 및 IP 분석 보고서 배열 — 단일 ip_analysis 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 IP 분석 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준 status, IP 및 지리적 위치 데이터, 기기 핑거프린트, warnings[]를 포함한 전체 보고서입니다. 중복된 (node_id, ip_address, device_fingerprint) 항목은 서버 측에서 중복 제거됩니다.

위치 검증 단계마다 하나씩 생성되며, 각 단계에서 수락된 시도를 나타내는 위치 검증 결과 배열입니다. 위치 검증 단계에서 데이터가 생성될 때까지 null입니다. 동일한 단계의 이전 시도는 geolocation_attempts에 포함됩니다.

이 세션의 모든 위치 인증 단계 시도 내역(오래된 순)입니다. 재제출로 대체된 시도는 제외됩니다. 응답 속성을 통해 geolocation_checks를 보류하는 워크플로는 이 목록도 보류합니다.

데이터베이스 검증 보고서 배열 — 단일 database_validation 객체가 아닌 항상 JSON 배열입니다. 하나 이상의 DB 검증 단계에서 데이터가 생성될 때까지 null입니다. 각 항목은 node_id, 기능 수준의 status, screened_data, 서비스별 validations[](각각 레지스트리 source_data 포함), warnings[]를 포함하는 전체 보고서입니다. screened_data 및 source_data 필드는 국가별로 다릅니다:

ARG (아르헨티나): screened_data: {document_number, selfie, gender, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, date_of_death, tax_id, tax_id_type, face_match_score, sit_1_since, banks, last_position, highest_position, rejected_checks}. RENAPER 생체 얼굴 대조 검증을 사용합니다. 신분증(예: 운전면허증)에 성별이 명시되어 있지 않은 경우 얼굴 분석 또는 이름에서 자동으로 추론됩니다.

BOL (볼리비아): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender}

BRA (브라질): screened_data: {tax_number, first_name, last_name, date_of_birth}. 일치하는 CPF 조회가 성공한 경우 source_data에는 항상 {identification_number, first_name, last_name, date_of_birth, lgpd_minor, minor_under_18, minor_under_16}이 포함됩니다. 성인 조회가 성공하면 해당 플래그는 false로 설정됩니다. Receita Federal Consulta CPF 서비스는 LGPD로 인해 보류된 데이터와 함께 HTTP 422(18세 미만 미성년자) 또는 451(16세 미만 미성년자)을 반환할 수 있습니다. 이러한 경우 source_data는 미성년자 플래그를 적절하게 true로 설정하고, 업스트림 HTTP 상태를 포함하며, 필드 수준 검증은 no_match가 됩니다. 전체 코드 목록은 데이터베이스 검증 결과 코드 참조 문서의 브라질 섹션을 확인하세요.

CHL (칠레): screened_data: {personal_number, first_name, last_name, date_of_birth}. source_data: {identification_number, first_name, last_name, date_of_birth, gender}

COL (콜롬비아): screened_data: {document_number, document_type, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, document_type}

CRI (코스타리카): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

DOM (도미니카 공화국): screened_data: {personal_number}. source_data: {identification_number} (유효/무효만 반환)

ECU (에콰도르): screened_data: {personal_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, street, formatted_address, gender, nationality, education, marital_status, spouse, mother_name, father_name, profession}

ESP (스페인): screened_data: {personal_number, document_type, expiration_date, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, document_type, expiration_date}

GTM (과테말라): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

HND (온두라스): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

MEX (멕시코): screened_data: {personal_number (CURP), first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, date_of_birth, gender, nationality, curp_status, state_of_birth, doc_probatorio, registration_year, registration_state, registration_municipality, num_acta, crip, issuing_state_code, foreign_registry_number, folio_carta, folio_certificado}. RENAPO 주민등록 레지스트리를 사용합니다. 멕시코의 경우 추가적인 개별 검증으로 별도의 INE 유효성 검사 서비스도 이용할 수 있습니다.

PAN (파나마): screened_data: {personal_number, selfie}. source_data: {identification_number}. SIB 생체 인식 검증을 사용합니다

PER (페루): screened_data: {personal_number (DNI), first_name, last_name}. source_data: {identification_number, first_name, last_name, paternal_name, maternal_name, verification_number, verification_letter}

PRY (파라과이): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

SLV (엘살바도르): screened_data: {document_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

URY (우루과이): screened_data: {personal_number, date_of_birth, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name}

VEN (베네수엘라): screened_data: {document_number, first_name, last_name}. source_data: {identification_number, first_name, last_name, full_name, gender, date_of_birth, document_type}

법인 등기부 확인입니다. session_kind = business인 경우에만 존재합니다. 각 항목은 전체 법인 등기부 payload를 포함합니다.

종합 주요 인물 확인입니다. session_kind = business인 경우에만 표시됩니다. 각 항목은 2개 버킷 형태(registry, submitted, ubo_kyc_summary)를 사용합니다.

워크플로 노드별로 그룹화된 문서 검증 확인 항목입니다. session_kind = business인 경우에만 표시됩니다.

사용자 및 기업 세션에 대해 include=resubmissions가 포함된 경우에만 반환됩니다. 재제출 요청당 하나의 항목이 오래된 순서대로 반환됩니다. 각 항목에는 요청 전 재제출된 단계가 반환한 결과가 포함되어 있으므로 이전 제출 내용을 계속 읽을 수 있습니다. 세션을 삭제하면 모든 제출 내용이 삭제됩니다.