블로그 · 2026년 3월 6일

개발자를 위한 맞춤형 KYC 웹훅 리스너 구축 가이드 (KO)

견고한 웹훅 리스너 구축은 실시간 KYC 업데이트에 필수적입니다. 이 가이드는 KYC 신원 확인 결과를 효율적으로 처리할 수 있도록 구성부터 보안까지 필수 단계를 다룹니다.

작성자: Didit2026년 3월 6일업데이트됨 2026년 5월 21일

보안 웹훅 구성KYC 제공업체로부터의 재생 공격을 방지하고 데이터 무결성을 보장하기 위해 HMAC-SHA256 서명 확인 및 타임스탬프 유효성 검사를 통해 보안 웹훅 엔드포인트를 구현합니다.

실시간 KYC 처리웹훅을 활용하여 신원 확인 세션 상태에 대한 즉각적인 알림을 받아 사용자 프로필을 즉시 업데이트하고 온보딩 워크플로우를 간소화합니다.

강력한 오류 처리일시적인 문제를 관리하고 중요한 KYC 데이터가 손실되지 않도록 재시도 및 데드 레터 큐를 포함한 포괄적인 오류 처리 기능을 갖춘 웹훅 리스너를 설계합니다.

Didit의 간소화된 통합Didit은 명확한 API 문서, 구성 가능한 버전, 자동 비밀 키 순환을 통해 웹훅 설정을 간소화하여 실시간 KYC 결과를 모든 애플리케이션에 안전하고 효율적으로 통합할 수 있도록 합니다.

웹훅을 통한 실시간 KYC의 힘

오늘날 빠르게 변화하는 디지털 경제에서 실시간 신원 확인(KYC)은 더 이상 사치가 아닌 필수입니다. 기업은 사기를 방지하고 규정을 준수하기 위해 사용자 온보딩을 빠르고 안전하게 처리하고 신원을 즉시 확인해야 합니다. 상태 업데이트를 위해 API를 폴링하는 방식도 작동할 수 있지만, 이는 비효율적이며 지연을 초래할 수 있습니다. 바로 이 지점에서 웹훅이 빛을 발합니다. 웹훅은 KYC 제공업체가 확인 세션의 상태가 변경될 때마다 애플리케이션에 알릴 수 있는 즉각적인 이벤트 기반 메커니즘을 제공합니다. 이를 통해 즉각적인 의사 결정, 더 빠른 사용자 온보딩 및 우수한 고객 경험이 가능해집니다.

개발자에게 맞춤형 웹훅 리스너를 구축한다는 것은 KYC 워크플로우를 제어한다는 것을 의미합니다. 기다릴 필요 없이 시스템이 반응합니다. 성공적인 신분증 확인, 실패한 라이브니스 확인 또는 AML 스크리닝 경고 등 웹훅은 필요한 정보를 정확히 필요한 시점에 전달합니다. AI 기반 플랫폼인 Didit은 이러한 실시간 패러다임을 수용하여 기존 인프라에 원활하게 통합되는 강력한 웹훅 기능을 제공합니다.

Didit으로 웹훅 엔드포인트 구성하기

Didit과 같은 제공업체와 웹훅 엔드포인트를 설정하는 것은 간단합니다. Didit은 API 또는 비즈니스 콘솔을 통해 웹훅 URL을 구성하고, 페이로드 버전(최신 기능을 위해 v3 권장)을 지정하고, 비밀 키를 직접 관리할 수 있도록 합니다. 이러한 유연성은 특정 요구 사항에 맞게 통합을 조정할 수 있도록 보장합니다.

구성할 때 Didit이 알림을 보낼 URL을 정의합니다. 이 URL은 공개적으로 액세스할 수 있어야 하며 POST 요청을 수신할 수 있어야 합니다. Didit은 또한 data_retention_months 매개변수를 설정하여 세션 데이터가 저장되는 기간을 제어할 수 있도록 하며, 이는 규정 준수에 중요합니다. 확인 세션의 capture_method(모바일, 데스크톱 또는 둘 다)를 지정할 수도 있으며, 향상된 보안을 위해 secret_shared_key를 순환하여 이전 키를 즉시 무효화할 수도 있습니다.

예를 들어, Didit의 관리 API를 사용하여 웹훅 구성을 업데이트할 수 있습니다.

PATCH /v3/webhook/
{
  "webhook_url": "https://myapp.com/webhooks/didit",
  "webhook_version": "v3",
  "capture_method": "both",
  "data_retention_months": 12
}

이 간단한 API 호출은 Didit에게 실시간 KYC 업데이트를 어디로 보낼지, 그리고 어떻게 포맷할지 알려주어 신분증 확인 및 수동/능동 라이브니스 확인과 같은 프로세스에 필요한 중요한 정보를 받을 수 있도록 합니다.

안전하고 신뢰할 수 있는 웹훅 리스너 구축

민감한 KYC 데이터를 처리할 때는 보안이 가장 중요합니다. 웹훅 리스너는 모든 수신 요청의 진위와 무결성을 확인하도록 설계되어야 합니다. Didit은 웹훅 서명을 검증하는 데 사용할 secret_shared_key를 제공합니다. 이 프로세스는 일반적으로 다음을 포함합니다.

요청 수신: 엔드포인트가 Didit으로부터 POST 요청을 수신합니다.
서명 추출: Didit은 HMAC-SHA256 서명이 포함된 X-Signature 헤더를 포함합니다.
서명 확인: 원시 요청 본문과 secret_shared_key를 사용하여 자체 HMAC-SHA256 서명을 계산합니다. 이 계산된 서명은 X-Signature 헤더의 서명과 일치해야 합니다. 중요한 것은 서명을 확인하기 전에 JSON 본문을 구문 분석하지 마십시오.
타임스탬프 유효성 검사: 웹훅 페이로드에는 타임스탬프도 포함됩니다. 이 타임스탬프가 최근인지(예: 5분 이내) 확인하여 재생 공격을 방지합니다.
페이로드 처리: 확인되면 JSON 본문을 안전하게 구문 분석하고 KYC 결과를 처리할 수 있습니다.

보안 외에도 신뢰성은 핵심입니다. 리스너는 멱등성을 가져야 합니다. 즉, 동일한 이벤트를 여러 번 처리해도 한 번 처리하는 것과 동일한 효과를 가져야 합니다. 로깅, 일시적인 실패에 대한 재시도, 그리고 지속적으로 처리 실패하는 이벤트에 대한 데드 레터 큐를 포함한 강력한 오류 처리를 구현하십시오. 이를 통해 AML 스크리닝 및 모니터링 또는 연령 추정에서 얻은 중요한 신원 확인 결과가 절대 누락되지 않도록 합니다.

웹훅 이벤트 처리 및 핵심 로직과의 통합

웹훅 이벤트를 안전하게 수신하고 검증한 후 다음 단계는 이를 애플리케이션의 핵심 로직과 통합하는 것입니다. Didit의 웹훅은 상태(예: approved, rejected, pending), 상태 이유 및 관련 데이터 포인트를 포함하여 확인 세션에 대한 자세한 정보를 제공합니다. 예를 들어, 성공적인 신분증 확인 이벤트는 사용자 프로필을 업데이트하여 확인됨으로 표시하고 특정 기능에 대한 액세스를 잠금 해제할 수 있습니다.

수신할 수 있는 이벤트 유형을 고려하십시오:

세션 완료: 가장 일반적인 이벤트로, 확인 세션이 최종 상태(승인됨, 거부됨 또는 수동 검토)에 도달했음을 나타냅니다.
문서 확인됨: 신분증 확인에만 해당하며, 문서의 진위를 확인합니다.
라이브니스 확인 통과/실패: 사기 방지에 중요하며, 라이브니스 확인 결과를 나타냅니다.
AML 경고: AML 스크리닝 중 일치 항목이 발생했음을 나타내며, 추가 조사가 필요합니다.

리스너는 이러한 이벤트를 구문 분석하고 시스템 내에서 적절한 작업을 트리거해야 합니다. 여기에는 데이터베이스에서 사용자 상태 업데이트, 내부 알림 전송 또는 다단계 온보딩 워크플로우에서 추가 단계 시작이 포함될 수 있습니다. Didit의 모듈식 아키텍처는 이러한 이벤트를 오케스트레이션된 워크플로우에 직접 공급하여 확인 결과에 대한 동적 반응을 가능하게 합니다.

Didit이 도움이 되는 방법

Didit은 복잡한 신원 확인 세계를 단순화하도록 설계되었으며, 웹훅 시스템은 그 대표적인 예입니다. AI 기반의 개발자 우선 플랫폼으로서 Didit은 웹훅 통합을 간편하게 만드는 깔끔한 API와 포괄적인 문서를 제공합니다. 우리는 무료 핵심 KYC를 제공하여 선불 비용 없이 시작할 수 있도록 하며, 모듈식 아키텍처는 필요한 것만 사용하고 비용을 지불할 수 있도록 합니다.

Didit을 통해 다음과 같은 이점을 누릴 수 있습니다:

원활한 구성: API 또는 직관적인 비즈니스 콘솔을 통해 웹훅 URL, 버전 및 비밀 키를 쉽게 설정하고 관리할 수 있습니다.
강력한 보안 기능: HMAC-SHA256 서명 확인 및 타임스탬프 유효성 검사에 대한 내장 지원은 모든 수신 웹훅 데이터의 무결성과 진위성을 보장합니다.
자세한 페이로드: 신분증 확인, 수동 및 능동 라이브니스, 1:1 얼굴 일치, AML 스크리닝 및 모니터링, 주소 증명 및 연령 추정과 같은 제품을 다루는 모든 확인 이벤트에 대한 풍부하고 구조화된 데이터를 수신합니다.
오케스트레이션된 워크플로우: 웹훅 이벤트는 Didit의 코드 없는 워크플로우 빌더에 원활하게 통합되어 확인 결과에 대한 정교하고 자동화된 응답을 설계할 수 있습니다.
설정 비용 없음: 숨겨진 비용 없이 즉시 시작하고 강력한 신원 확인 기능을 애플리케이션에 통합하십시오.

Didit의 개발자 우선주의에 대한 약속은 통합 상용구에 시간을 덜 쓰고 혁신적인 기능을 구축하는 데 더 많은 시간을 할애하면서 KYC 프로세스가 안전하고 규정을 준수하며 번개처럼 빠르도록 보장합니다.

시작할 준비가 되셨습니까?

Didit의 실제 작동을 보고 싶으십니까? 오늘 무료 데모를 받으세요.

Didit의 무료 티어로 무료로 신원 확인을 시작하세요.