시작하기
연동 / SDK
사용자 인증
기업 확인
거래 모니터링
변경 내역라이프사이클 다이어그램
상태 세부 정보
PATCH /v3/users/{vendor_data}/update-status/ 또는 PATCH /v3/businesses/{vendor_data}/update-status/로 상태를 변경하면 webhook(user.status.updated / business.status.updated)이 발생하므로 하위 시스템이 실시간으로 대응할 수 있습니다.라이프사이클 단계
생성
엔티티는 다음 세 가지 방법 중 하나로 생성됩니다.
- 새
vendor_data로 세션을 시작하면 자동 생성됩니다. 엔티티는ACTIVE상태로 만들어집니다. POST /v3/users/create/또는POST /v3/businesses/create/를 사용해 API로 사전 생성됩니다. 상태 기본값은ACTIVE입니다.- 컴플라이언스 담당자가 콘솔에서 생성합니다. 담당자가 다르게 지정하지 않으면 상태는
ACTIVE로 시작합니다.
uuid와 고객이 소유한 vendor_data 식별자가 부여됩니다.인증
세션은
vendor_data를 통해 엔티티에 연결됩니다. 각 세션은 설정된 워크플로를 거치며, 여기에는 신분증 인증, 라이브니스 감지, 얼굴 대조, AML, 문서 확인, KYB의 경우 법인 등기부 조회 등이 포함됩니다.완료된 세션은 엔티티의 누적 카운터를 업데이트합니다.session_count,approved_count,declined_count,in_review_countfeatures맵은 모든 세션에 걸쳐 각 기능의 최신 상태를 보여 줍니다(예:{ "id_verification": "APPROVED", "aml": "IN_REVIEW" }).- 프로필 필드는 가장 최근에 승인된 세션에서 반영됩니다(예:
full_name,date_of_birth,portrait_image).
활성 사용
엔티티에 승인된 세션이 하나 이상 존재하면 다음 작업을 수행할 수 있습니다.
- 거래 페이로드에
vendor_data를 넣어 엔티티를 참조하는 거래를 제출합니다. - 지속적인 AML 모니터링을 실행합니다. 제재, PEP, 부정적 언론 보도 목록을 주기적으로 다시 검색합니다.
- 일정에 따라 재인증합니다. 정해진 간격으로 같은
vendor_data에 대해 새 세션을 만듭니다. - 세션과 거래 전반의 위험 신호를 집계합니다.
상태 전환
엔티티 상태는 자동으로 또는 수동으로 변경됩니다.자동 전환
- 거래가 검토 임계값을 넘거나 규칙이 엔티티를 감시 목록에 추가하면
ACTIVE → FLAGGED로 바뀝니다. - 얼굴 생체 정보가 차단 목록 항목과 일치하면
ACTIVE → BLOCKED로 바뀝니다.
USER 항목(vendor_data)에 의해 상태가 BLOCKED로 설정됩니다.수동 전환은 분석가가 콘솔에서 상태를 변경하거나 update-status 엔드포인트를 호출할 때 발생합니다.모든 전환은 user.status.updated 또는 business.status.updated webhook을 발생시킵니다.활동 타임스탬프
엔티티는 활동을 추적하여 오래되었거나 활발한 프로필을 식별하는 데 도움을 줍니다.
휴면 엔티티를 필터링하거나, 재인증을 예약하거나, 지속적인 모니터링을 트리거하는 데 이 타임스탬프를 사용하십시오.
라이프사이클 중 발생하는 이벤트
페이로드 구조와 전송 방식은 엔티티 webhook을 참조하십시오.
다음 단계
vendor_data 연결
vendor_data가 세션, 거래, 엔티티를 어떻게 연결하는지 설명합니다.사용자 작업
사용자 엔티티를 생성, 업데이트, 상태 변경, 삭제하는 방법을 설명합니다.
기업 작업
기업 엔티티를 생성, 업데이트, 상태 변경, 삭제하는 방법을 설명합니다.