사전 준비 사항
- KYB가 활성화된 Didit 애플리케이션. 필요한 경우 business.didit.me에서 생성합니다.
- Developer Settings → API Keys에서 발급받은 API 키.
- 인터넷에서 접근 가능한 webhook endpoint(결정 webhook 수신용).
단계
1
콘솔에서 KYB 워크플로 생성
Workflows → Create workflow로 이동합니다. 워크플로 유형으로 기업 확인(KYB)을 선택합니다.필요한 기능을 활성화합니다:
- 법인 등기부 조회(필수)
- 기업 AML(권장)
- 주요 인물(대부분의 규제 대상 산업에서 필수)
- 문서(선택 사항 — 필요한 문서 유형 선택)
workflow_id를 복사합니다. 다음 단계에서 사용하게 됩니다.2
API를 통해 기업 확인(KYB) 세션 생성
session_id, session_number, 그리고 기업 담당자에게 전달할 호스팅 인증 링크인 url이 포함됩니다. 워크플로 유형(KYB)에 따라 세션이 기업 세션으로 자동 지정됩니다.3
기업 담당자에게 링크 전송
이메일이나 메신저를 통해 회사 관리자에게
url을 전달합니다. 관리자가 링크를 열어 등기 데이터를 입력하고, 주요 인물 및 실소유자(UBO)를 추가하며, 문서를 업로드합니다.브랜딩, 로고, 도메인으로 호스팅 환경을 맞춤 설정할 수 있습니다. 자세한 내용은 화이트 라벨을 참고하십시오.4
상태 webhook 수신
기업이 절차를 완료하고 KYB 처리가 최종 상태에 도달하면, Didit은 webhook endpoint로
status.updated 이벤트를 POST 요청으로 전송합니다. 기업 세션 이벤트는 data 내에 session_kind: "business"를 포함하므로, 이를 필터링하여 이벤트를 KYB 핸들러로 라우팅할 수 있습니다.이벤트를 신뢰하기 전에 X-Signature-V2 HMAC 서명을 검증하고(참고: webhooks), 다운스트림 로직을 트리거합니다. webhook을 등록할 때 반환되는 대상의 secret_shared_key를 .env 파일에 DIDIT_WEBHOOK_SECRET으로 저장하십시오.payload 예시:5
결정 조회(선택 사항)
status.updated webhook payload에는 이미 전체 결정 내용이 포함되어 있습니다. webhook을 구독하지 않았거나 나중에 필요에 따라 결정을 다시 가져오려는 경우에만 이 endpoint를 호출하면 됩니다.6
결정에 따른 조치
status 값에 따라 조치를 취합니다:"Approved"— 기업 온보딩을 진행합니다."Declined"— 거부하고 결정의warnings[]태그를 기록합니다."In Review"— 분석가의 결정을 기다립니다. 검토가 완료되면 추가 webhook이 전송됩니다.
Node.js 예시
자동 처리 항목
- 190+개 관할 구역에 대한 법인 등기부 조회.
- 등기 데이터로부터 실소유자(UBO) 및 임원 정보 추출.
- 기업 차원의 AML 스크리닝(제재, PEP, 부정적 언론 보도).
- 식별된 각 관련자에 대한 개인 차원의 AML 스크리닝.
- 문서 OCR 및 상호 교차 검증.
vendor_data를 키로 하는 기업 프로필 생성 및 집계.
다음 단계
연동 가이드
엔드투엔드 아키텍처, 폴링 vs webhook, 재시도 로직.
KYB webhook
모든 KYB 이벤트 및 payload 형식.
상태
세션, 기능 및 등기 상태 레퍼런스.
응답 스키마
전체 KYB 결정 payload.
기업 엔터티
세션 간에 프로필이 집계되는 방식.