​
Webhook: created

{
    "webhook_trigger": "created",
    "submission_id": "{submission_id}",
    "kyc_result": {
        "status": "incomplete"
    },
    "cf": {
        "cf1": "{custom_field1}",
        "cf2": "{custom_field2}",
        "cf3": "{custom_field3}"
    },
    "userid": "{user_id}",
    "tokenId": "{token_id}",
    "retryCode": "{retry_code}",
    "attempts": 1,
    "ipAddress": "{ip_address}"
}
​
webhook_trigger
string

웹훅 트리거 타입 - created 최초 Submission 이 생성된 상태를 의미

​
submission_id
string

KYC 제출 건별 고유 식별자

​
kyc_result
object

KYC 제출 결과를 포함하는 객체

​
cf
object

사용자 정의 필드 (cf1, cf2, cf3) 데이터를 포함하는 객체

​
userid
string

고객사에서 정의한 KYC 제출자 고유 식별자

​
tokenId
string

비공개 모드의 라이브 폼 제출 시 사용된 토큰 ID

​
retryCode
string

재시도가 발생된 사유 코드

​
attempts
int

재시도 횟수

​
ipAddress
string

제출자의 IP 주소

​
Webhook: retry

retry-response.json
{
    "webhook_trigger": "retry",
    "submission_id": "{submission_id}",
    "kyc_result": {
        "status": "incomplete"
    },
    "cf": {
        "cf1": "{custom_field1}",
        "cf2": "{custom_field2}",
        "cf3": "{custom_field3}"
    },
    "userid": "{user_id}",
    "tokenId": "{token_id}",
    "ipAddress": "{ip_address}"
    "retryCode": "{retry_code}",
    "attempts": 1
}
​
webhook_trigger
string

웹훅 트리거 타입 - Submission 진행 간에 retry 가 발생된 경우

​
submission_id
string

KYC 제출 건별 고유 식별자

​
kyc_result
object

KYC 제출 결과를 포함하는 객체

​
cf
object

사용자 정의 필드 (cf1, cf2, cf3) 데이터를 포함하는 객체

​
userid
string

고객사에서 정의한 KYC 제출자 고유 식별자

​
tokenId
string

비공개 모드의 라이브 폼 제출 시 사용된 토큰 ID

​
ipAddress
string

제출자의 IP 주소

​
retryCode
string

재시도가 발생된 사유 코드

​
attempts
int

재시도 횟수

​
Retry Code

retryCodeID documentKnowledge BasedDescription
recognition_failOX시스템이 신분증 인식에 실패한 경우
expired_idOX만료일자가 지난 ID
document_expiredOX제출 서류가 만료된 경우
invalid_back_documentOX앞면과 뒷면의 이미지 정보가 불일치
invalid_dual_sideOX양면의 이미지가 잘못 인식된 경우
document_country_mismatchOX문서의 국가 불일치
glare_detectedOX빛반사 감지
image_too_blurryOX이미지가 흐릿함
recaptured_documentOX문서 이미지를 재촬영함
screen_detectedOX화면이 감지됨
black_white_documentOX문서가 흑백인 경우
missing_birth_dateOX생년월일이 누락됨
document_name_mismatchOX문서상의 이름 불일치
document_dob_mismatchOX문서상의 생년월일 불일치
image_forgeryOX위조된 이미지
text_forgeryOX위조된 텍스트
feature_verification_failedOX특징 확인에 실패함
image_editedOX수정된 이미지인 경우
fake_idOX가짜 ID
artificial_imageOX인위로 바꾼 이미지
artificial_textOX인위로 바뀐 텍스트
check_digit_failedOX숫자 확인에 실패함
physicial_document_missingOX실물 문서가 누락됨
missing_expiry_dateOX만료일자 정보가 누락됨
missing_issue_dateOX발생일자 정보가 누락됨
missing_document_numberOX문서번호 정보가 누락됨
missing_personal_numberOX주민번호 정보가 누락됨
missing_nameOX이름 정보가 누락됨
bank_authentication_failOX인증번호, 이름 모두 확인에 실패함
bank_authentication_code_failOX인증번호 확인에 실패함
bank_authentication_name_failOX이름 확인에 실패함
blacklist_countryOO발급국가 기준으로 blacklist country 의 국가가 제출된 경우
mrz_protocol_failOXMRZ 프로토콜 인식이 불가한 경우
Identity_verification_failOXID 신원 인증에 실패한 경우
barcode_protocol_failOX바코드 프로토콜 인식에 실패한 경우
no_faceOO셀피 촬영에 얼굴이 없는 경우
face_compare_underscoreOO얼굴 비교 점수가 기준 미달인 경우
Id_livness_failOXID 의 Liveness 검사에 실패한 경우
liveness_errorOOLiveness 검사에 오류가 발생된 경우
liveness_failOOPassive Liveness 점수가 기준 미달인 경우
liveness_fail_activeOOActive Liveness 점수가 기준 미달인 경우
too_many_retryOO재시도 회수를 초과한 경우
VERIFICATION_CODE_MISS_MATCHXO인증 코드가 입력한 코드와 불일치함