vendor_data는 모든 세션과 거래에 함께 보내서 해당 항목을 사용자 또는 기업 엔티티에 연결하는 식별자입니다. 엔티티 집계에서 가장 중요한 필드이며, 이 값을 올바르게 설정하면 프로필 이력, 거래 모니터링, 차단 목록 적용, 지속적인 AML 모니터링 등 이후의 모든 기능이 원활하게 동작합니다.
개요
vendor_data는 직접 선택하는 문자열입니다. Didit은 이를 불투명한 식별자로 취급하며 내용을 해석하지 않습니다. 일반적인 값은 다음과 같습니다.
연결 방식
vendor_data 값과 함께 세션 또는 거래를 제출하면 다음과 같이 처리됩니다.
- Didit이 해당
vendor_data를 가진 엔티티를 귀사의 애플리케이션에서 찾습니다. - 엔티티가 있으면 새 객체를 그 엔티티에 연결합니다.
- 엔티티가 없으면 Didit이 엔티티를 생성(
status: ACTIVE)하고 새 객체를 연결합니다.
POST /v3/session/— KYC 및 기업 확인(KYB) 세션POST /v3/transactions/— 거래(신청자와 거래 상대방 모두에 대해)- 거래 페이로드 내부의
applicant.vendor_data/counterparty.vendor_data필드
고유성 및 적용 범위
vendor_data는 Didit 전체가 아니라 애플리케이션별로 고유합니다.
따라서 스테이징 앱과 프로덕션 앱에서 같은
vendor_data를 사용해도 충돌이 발생하지 않습니다. 또한 사용자 user-42와 기업 user-42를 함께 사용해도 충돌하지 않지만, 명확성을 위해 권장하지 않습니다.
vendor_data를 생략하면 발생하는 일
vendor_data 없이 세션을 생성할 수 있습니다. 이 경우 다음과 같습니다.
- 해당 세션에 대한 엔티티가 생성되지 않습니다.
- 세션이 고아 상태가 되며, 어떤 사용자 또는 기업 프로필에도 나타나지 않습니다.
- 나중에
vendor_data로 세션을 조회할 수 없습니다.session_id로만 조회할 수 있습니다.
vendor_data를 제공하십시오.
예시: 엔티티를 미리 생성한 뒤 세션 실행
GET /v3/users/user-42/를 호출하면 세션 수, 승인 및 거부 카운터, 연결된 거래, 최신 프로필 데이터를 확인할 수 있습니다.
외부 ID 마이그레이션
기존 KYC 공급업체에서 Didit으로 옮기는 경우, 처음부터 기존의 안정적인 사용자 ID를vendor_data로 전달하십시오. 이렇게 하면 다음 작업이 쉬워집니다.
- Didit 데이터를 내부 데이터베이스와 대조합니다.
- 세션을 실행하기 전에 콘솔의 CSV 가져오기로 과거 사용자를 일괄 등록합니다.
- 나중에 거래 모니터링을 위해 Didit으로 마이그레이션할 때도 관계를 유지합니다.
규칙, 관례 및 권장 사항
다음 단계
사용자 개요
사용자 엔티티와 작업에 대한 자세한 설명입니다.
기업 개요
기업 엔티티와 작업에 대한 자세한 설명입니다.
세션 생성
vendor_data를 사용한 인증을 시작합니다.
거래 생성
엔티티에 연결된 거래를 제출합니다.