시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역"In Progress", "Not Finished"처럼 대소문자를 구분하는 정확한 문자열로 상태 값을 반환하며, webhook에도 같은 문자열이 전달됩니다. 대문자 이름이 아니라 이 문자열과 정확히 일치하는지 확인하십시오.
세션 상태
기업 확인(KYB) 세션의 전체 상태입니다. 가장 자주 분기 처리에 사용하게 될 필드입니다."Awaiting User"는 일시적인 상태입니다. 세션을 이 상태에서 수동으로 옮길 필요는 없습니다. 최종 사용자가 대기 중인 작업(예: 주요 인물 목록 제출 또는 요청된 문서 재업로드)을 완료하면 Didit이 세션을 다시 평가하고, 결과에 따라 "In Review", "Approved", "Declined" 중 하나로 자동 전환합니다.기능 상태
각 KYB 기능은 고유한 상태를 가지며, 이 상태가 모여 세션 상태를 구성합니다.KYB 기능 이름
다음은 KYB 세션의features 값이자 webhook에 사용되는 값입니다.
KYB_REGISTRY: 법인 등기부 조회AML: 기업 단위 AML 스크리닝KYB_DOCUMENTS: 문서 수집 및 OCRKYB_KEY_PEOPLE: 주요 인물, 즉 실소유자(UBO), 주주, 이사, 대리인 및 기타 임원
레지스트리 상태(제공자 제공)
공신력 있는 등기 출처에서 가져온 기업의 공식 상태입니다. 관할 지역별 등기부가 보고한 법인의 법적 또는 규제상 지위를 반영하므로, 정확한 값은 출처에 따라 다릅니다. KYB 판정 결과의company.registry_status 아래에 표시됩니다.
registry_status는 등기부의 원시 값을 반영하므로, 제품 로직을 구동하기 위해 관할 지역과 무관하게 일관된 지표가 필요하다면 아래의 verification_status를 사용하십시오.기업 확인 상태
기업 조회 결과마다 제공되는, 비즈니스 관점의 표준화된 상태입니다. 국가와 출처에 따라 다른 등기 및 기업 상태를 하나의 일관된 지표로 정규화하여, 제품 내에서 바로 해석할 수 있습니다. KYB 판정 결과의company.verification_status 아래에 표시됩니다.
기업 조회 상태
외부 또는 공식 등기부에서 특정 기업 레코드를 가져오는 진행 상황을 나타냅니다. 해당 기업에 대해 가져온 정보가 얼마나 완전한지 판단하는 데 사용하십시오. KYB 판정 결과의company.fetch_status 아래에 표시됩니다.
AML 확인 상태
스크리닝(기업 또는 개인)마다 반환됩니다.결정이 설명되는 방식
KYB 결정에는 단일 사유 코드 문자열이 포함되지 않습니다. 각 기능 배열(registry_checks[], document_verifications[], key_people_checks[], aml_screenings[])에는 KYB_* 및 AML 태그가 담긴 warnings[]가 포함되며, decision_trace에는 결정에 이른 과정이 기록됩니다.
KYB 경고에서 태그를 확인하고, 세션 상태와 함께 기록하십시오.
검토자가 플랫폼 자체 집계 결과와 다르게 상태를 직접 설정하면, 결정에 overridden_at 시각과 플랫폼이 설정했을 automatic_status를 담은 status_override가 포함됩니다.
응답 스키마를 참조하십시오.
다음 단계
응답 스키마
payload에서 각 상태가 표시되는 위치입니다.
위험 평가
KYB 결과를 좌우하는 요인입니다.
webhook
상태가 변경될 때 발생하는 이벤트입니다.