Webhooks
Submit (제출)
이 이벤트는 새로운 KYC 정보가 시스템에 제출될 때 트리거됩니다. 제출은 사용자가 KYC 양식을 작성하여 제출하거나, API를 통해 KYC 데이터가 전송될 때 발생합니다. 이 이벤트를 통해 새로운 KYC 제출을 즉시 인지하고, 검증 프로세스를 시작하거나 필요한 초기 처리를 수행할 수 있습니다.
Submit Webhook 이 발생하는 시점은 KYC 상태가 Pending 이 되었을 때입니다.
- Approved (승인) → Approved (승인) 웹훅 트리거 발생, Submit 웹훅은 트리거 되지 않음
- Rejected (거절) → Rejected (거줄) 웹훅 트리거 발생, Submit 웹훅은 트리거 되지 않음
- Pending → Submit 웹훅이 트리거됨
submit-webhook-sample.json
웹훅 트리거 유형 - submit
는 제출 후 대기 (Pending) 상태를 의미
KYC가 최초 제출된 UTC 시간 (ISO 8601 형식)
KYC 제출 건별 고유 식별자
이름, 생년월일, 성별, 국적을 기준으로 중복 확인용 식별자가 생성됩니다. (*네 가지 기준이 모두 제공되면 항상 생성됩니다.)
사용자 정의 필드 (cf1, cf2, cf3) 데이터를 포함하는 객체
고객사에서 정의한 KYC 제출자 고유 식별자
비공개 모드의 라이브 폼 제출 시 사용된 토큰 ID
제출자의 IP 주소