메인 콘텐츠로 건너뛰기
vendor_data는 모든 세션과 거래에 함께 보내서 해당 항목을 사용자 또는 기업 엔티티에 연결하는 식별자입니다. 엔티티 집계에서 가장 중요한 필드이며, 이 값을 올바르게 설정하면 프로필 이력, 거래 모니터링, 차단 목록 적용, 지속적인 AML 모니터링 등 이후의 모든 기능이 원활하게 동작합니다.

개요

vendor_data는 직접 선택하는 문자열입니다. Didit은 이를 불투명한 식별자로 취급하며 내용을 해석하지 않습니다. 일반적인 값은 다음과 같습니다.
vendor_data에 PII(이메일, 전화번호, 원본 납세자 번호)를 직접 넣지 마십시오. 해시하거나 접두사를 붙이십시오. vendor_data는 webhook 페이로드에 나타나며, 엔티티가 존재하는 동안 무기한 저장됩니다.

연결 방식

vendor_data 값과 함께 세션 또는 거래를 제출하면 다음과 같이 처리됩니다.
  1. Didit이 해당 vendor_data를 가진 엔티티를 귀사의 애플리케이션에서 찾습니다.
  2. 엔티티가 있으면 새 객체를 그 엔티티에 연결합니다.
  3. 엔티티가 없으면 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를 사용한 인증을 시작합니다.

거래 생성

엔티티에 연결된 거래를 제출합니다.
마지막 수정일 2026년 11월 7일