웹훅 이벤트 - ARGOS Identity

웹훅이란?

웹훅은 특정 이벤트가 발생했을 때 실시간으로 알림을 받을 수 있는 기능입니다. KYC 데이터가 변경되거나 새로운 정보가 추가될 때마다 지정된 URL로 자동으로 알림을 보냅니다.

1. 웹훅은 언제 전송되나요?

웹훅은 서브미션이 생성·승인·거절·업데이트·삭제되는 등 아래 이벤트가 발생할 때마다 등록한 웹훅 URL로 전송됩니다. ARGOS Identity 웹훅으로 다음과 같은 실시간 업데이트를 받아보세요.

“webhook_trigger”: “created” → 서브미션이 생성된 경우
“webhook_trigger”: “retry” → 진행간에 재시도가 발생된 경우
“webhook_trigger”: “approved” → 심사(review) 결과로 서브미션이 승인된 경우
“webhook_trigger”: “rejected” → 심사(review) 결과로 서브미션이 거절된 경우
“webhook_trigger”: “submit” → 서브미션 상태가 보류(pending)된 경우
“webhook_trigger”: “updated” → 서브미션이 업데이트 된 경우 (PATCH/Submission API·대시보드 수정을 통한 KYC 상태 변경 포함)
“webhook_trigger”: “delete” → 서브미션이 삭제된 경우
“webhook_trigger”: “token_expired” → Token ID가 만료된 경우
“webhook_trigger”: “injection” → 서브미션에 Injection 이 진행된 경우
“webhook_trigger”: “aml” → aml 프로세스가 진행된 경우
“webhook_trigger”: “aml_monitor” → aml_monitor 프로세스가 진행된 경우

Approved

Rejected

Updated

Delete

Submit

Token expired

Data injection

AML 검색 결과

AML 온고잉 모니터링 결과

웹훅을 활용하면 KYC 프로세스의 모든 단계를 실시간으로 모니터링하고, 필요한 조치를 즉시 취할 수 있어 고객 온보딩 프로세스를 더욱 효율적으로 관리할 수 있습니다.

2. 웹훅 URL은 어디에 등록하나요?

웹훅 URL은 대시보드 설정 > Access Management의 Webhook URL 항목에 등록합니다.

대시보드 로그인

ID check 대시보드에 로그인합니다.

설정 메뉴 접근

대시보드 상단 네비게이션 바에서 설정 메뉴를 클릭합니다.

Access Management 페이지 이동

좌측 사이드바의 General 섹션에서 Access Management를 선택합니다.

웹훅 URL 입력

Webhook URL 섹션을 찾아 입력 필드에 원하는 웹훅 주소를 입력합니다. 입력한 URL은 HTTPS 프로토콜을 사용해야 하며, 유효한 형식이어야 합니다.

설정 저장

페이지 하단의 저장 버튼을 클릭하여 변경사항을 적용합니다.

3. 안전한 데이터 전송을 위한 암호화 옵션을 활성화하세요

ARGOS Identity는 웹훅을 통해 전송되는 민감한 KYC 데이터를 보호하기 위해 암호화 옵션을 제공합니다. 이 기능을 활성화하면 모든 웹훅 데이터가 자동으로 암호화되어 더욱 안전한 정보 교환이 가능해집니다.

a. 암호화된 웹훅 데이터는 어떤 모습인가요?

암호화가 적용된 웹훅 응답은 다음과 같은 형식으로 전달됩니다:

data-encrpyted.json

{
  "response": {
    "body": "encrypted-string"
  }
}

여기서 encrypted-string은 원본 데이터를 암호화한 결과입니다.

b. 암호화 옵션을 쉽게 설정하세요

대시보드 설정의 보안 데이터 전송(Secure Data Transfer) 옵션

대시보드 로그인

ID check 대시보드에 로그인합니다.

설정 메뉴 접근

대시보드 상단 네비게이션 바에서 설정 메뉴를 클릭합니다.

Access Management 페이지 이동

좌측 사이드바의 General 섹션에서 Access Management를 선택합니다.

안전한 데이터 전송 옵션 활성화

안전한 데이터 전송” 옵션을 켭니다.

설정 저장

페이지 하단의 저장 버튼을 클릭하여 변경사항을 적용합니다.

이제 모든 웹훅 데이터가 암호화되어 전송되므로, KYC 프로세스의 각 단계에서 발생하는 중요한 정보를 더욱 안전하게 주고받을 수 있습니다.

시작하기

‘ID check API는 기업 고객이 KYC(Know Your Customer) 및 AML(Anti-Money Laundering) 프로세스를 보다 체계적이고 효율적으로 관리할 수 있도록 설계된 솔루션입니다. 이 API는 기존 시스템과의 원활한 통합을 지원하며, 사용자 데이터를 안전하게 처리하고 관리할 수 있는 기능을 제공합니다.

GET/Submission

이 API를 사용하면 제출된 ID check 데이터를 조회할 수 있습니다. 특정 제출 건의 상세 정보를 확인하거나 여러 제출 건의 목록을 필터링하여 가져올 수 있습니다.

GET/Submission 응답 필드 정의

GET/Submission API 응답에 포함되는 모든 필드에 대한 상세 정의

Create and Retry (생성 및 재시도)

Submission 이 최초 생성시 created 웹훅이 트리거 됩니다. 그리고 KYC 프로세스 상 retry 가 발생 시에는 retry 웹훅이 발생됩니다.

​웹훅이란?

​1. 웹훅은 언제 전송되나요?