KR
KYC(신원확인)⯆
KYB(법인 신원 확인)⯆
고객센터⯆

Retry/Error/Reject Codes

STEP 1

Step 1 - Retry Codes (200 ok)

'mrz_protocol_fail', 'barcode_protocol_fail'을 제외한 리트라이 코드는 대시보드의 'ID CARD: Validation' 옵션 적용에 따라 신분증 유효성을 확인할 때만 반환될 수 있습니다.

Retry CodeMessageDescription

mrz_protocol_fail

Failed to detect full MRZ

MRZ 인식에 실패 했을 경우

barcode_protocol_fail

Failed to read PDF417 Barcode

바코드 인식에 실패했을 경우

invalid_back_document

Front and back side image mismatch. Please retry with one ID

신분증 앞면과 뒷면의 이미지가 매칭되지 않음

document_country_mismatch

Front and back side image mismatch. Please retry with one ID

신분증 앞면과 뒷면의 발급 국가가 일치하지 않음

document_expired

Your ID is expired already. Please retry with valid ID

신분증의 만료 일자가 이미 지남

document_name_mismatch

Front and back side name mismatch. Please retry with one ID

신분증 앞면과 뒷면의 이름이 일치하지 않음

document_dob_mismatch

Front and back side birthdate mismatch. Please retry with one ID

신분증 앞면과 뒷면의 생년월일이 일치하지 않음

missing_expiry_date

Expiry date not detected. Please take clear picture

만료 일자 감지 실패 혹은 만료 일자가 신분증에서 인위적으로 지워짐

missing_issue_date

Issue date not detected. Please take clear picture

발급 일자 감지 실패 혹은 발급 일자가 신분증에서 인위적으로 지워짐

missing_birth_date

Birth date not detected. Please take clear picture

생년월일 감지 실패 혹은 생년월일이 신분증에서 인위적으로 지워짐

missing_document_number

Document number not detected. Please take clear picture

문서번호 감지 실패 혹은 문서번호가 신분증에서 인위적으로 지워짐

missing_personal_number

Identity number not detected. Please take clear picture

주민등록번호 감지 실패 혹은 신분증 상에서 인위적으로 지워짐

missing_name

Name not detected. Please take clear picture

이름 감지 실패 혹은 신분증 상에서 인위적으로 지워짐

glare_detected

Please retake ID image without light smudging

빛 반사(번짐)로 인해 신분증 인식 불가

recaptured_document

Retry with physical ID. recaptured screen not allowed

모니터 혹은 핸드폰 등에 띄워둔 이미지가 감지됨

screen_detected

Retry with physical ID. recaptured screen not allowed

모니터 혹은 핸드폰 등의 화면을 캡처한 이미지가 감지됨

image_forgery

Please retry with original ID

신분증 이미지에서 위조가 감지됨

feature_verification_failed

Please retry with original ID

제출된 이미지가 데이터베이스에 등록되어 있는 신분증 이미지와 일치하지 않음

image_edited

Please retry with original ID

이미지 편집 툴에 의해 수정된 사항이 감지됨

fake_id

Please retry with original ID

온라인에서 구할 수 있는 샘플 신분증 이미지가 감지됨

artificial_image

Please retry with original ID

인위적으로 생성된 신분증이 감지됨

artificial_text

Please retry with original ID

텍스트 위조가 감지됨

text_forgery

Please retry with original ID

텍스트 위조가 감지됨

check_digit_failed

Please retry with original ID

MRZ 영역 위조가 감지됨

image_too_blurry

Please retake ID image clearly

이미지가 흐릿해 데이터 인식이 불가능

black_white_document

Please retry with original ID

흑백으로 된 신분증(복사본)이 감지됨

physical_document_missing

Please take ID image in the right direction

카메라 각도가 틀어져 신분증 인식 실패

expired_id

Expired ID document, please use unexpired ID card.

신분증의 만료 일자가 지났을 경우

Id_livness_fail

Liveness validation of Id image failed. Failed for: {#pipelines}

공격 방지 옵션 사용 시, ID Card Liveness Score 가 1개 이상의 파이프라인에서 50점 미만 일 경우. #pipeline : Screen replay, Paper printed, Replace portraits

Step 1 - Error Codes(400 Error)

Error CodeMessageDescription

invalid_payload

Failed to parse the input data.

이미지 파일 없음

invalid_id_image

Invalid ID image. Please retry with another ID image.

이미지 파일의 경로가 잘못되었음

invalid_request

Failed to find the project. Please check the project ID.

프로젝트가 삭제되어 없을 경우

invalid_project

This project is not available.

프로젝트의 상태가 ‘close’ 상태일 경우

missing_parameters

Missing required parameters.

Input Data 필수 값이 들어오지 않았을 경우(Step1 - Input Data 참고)

invalid_id_type

Invalid id type: Id type must be passport, government_id or drivers_license.

지정된 ID type이 아닐 때(Step1 - Input Data 참고)

invalid_input_format

Invalid input type: {parameters}

입력 값의 포맷 맞지 않는 경우

invalid_email

Invalid email address format.

잘못된 이메일 형식

id_image_error

ID image processing error. Please retry.

ID 이미지 처리 에러

data_processing_error

Data processing error. Please retry.

데이터 저장 에러

save_image_error

ID image save error. Please retry.

ID 이미지 처리 혹은 저장 에러

processed_submission

  1. This submission is already processed.

  2. {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.

  1. Step 1제출이 완료된 Submission ID에 대해 Step 1 retry를 시도함

  1. Approved Period 옵션에 의해 다시 KYC를 제출할 수 없을 때

rejected_submission

{email} has an existing rejected submission. Not available to submit due to ‘rejected period’ option to prevent duplication.

Rejected Period 옵션에 의해 다시 KYC를 제출할 수 없을 때

reviewing

{email}’s KYC is currently reviewing. Please wait.

해당 이메일 계정에 아직 결과가 나오지 않아 'Pending' 상태에 있는 KYC가 있어 추가 제출을 받지 않음

not_an_id

Please take a picture of an ID card.

제출된 ID 이미지가 신분증이 아니라고 판단 될 경우

id_detection_error

ID detection error. Please retry.

제출된 ID 이미지가 신분증인지 여부 판단 중 오류가 발생 할 경우

ocr_fail

OCR not supported ID. Please retry with another ID.

'AI Supported Only'옵션과 연동되어 있으며, OCR 엔진이 지원하지 않는 신분증이 제출됨

invalid_id

Invalid ID. Please resubmit with another ID.

해당 국가의 정책으로 더 이상 유효하지 않은 신분증이 제출되었을 경우(Uzbekistan)

id_validation_error

ID validation server error. Please, retry.

ID validation 서버 오류

invalid_idType

This project is not using the Universal option.

Universal 옵션이 Off 인 상태인데, idType 에 ‘universal’ 로 제출한 경우. - Universal 옵션 사용 시에만 idType ‘universal’ 제출 가능. 그 이외엔 정확한 idType 입력 필수.

invalid_idType

ID Card issued from Korea cannot use universal id type.

한국 신분증인데, idType 에 ‘universal’ 로 제출한 경우. - issuingCountry 가 ‘KOR’ 인 경우, Universal 옵션 사용 여부와 관계없이 Universal 모드 사용 불가

invalid_idType

Cannot input specific idType in using universal option

Universal 옵션을 사용중인데, idType 에 특정 신분증 타입을 제출한 경우

missing_parameters

IdCard Back Image is required in using universal option

Universal 옵션을 사용하며 idType을 ‘universal’ 로 제출했으나, 신분증 뒷면 사진을 제출하지 않은 경우 - Universal 모드 사용시에는 신분증 뒷면 사진을 필수로 제출해야함.

id_liveness_error

ID liveness error.

공격 방지 옵션 사용 시, ID Card Liveness 검증 중 에러 발생.

STEP 2

Step 2 - Retry Codes (200 ok)

Retry CodeMessageDescription

identity_verification_fail

  1. ID verification failed: {message}. Please check the ID data.

  2. ID verification failed: Barcode information does not match. {message}. Please check the ID data.

  3. ID verification failed: EGN information does not match. {message}. Please check the ID data

  1. 한국 신분증 진위 확인 실패

  2. USA, CAN, MEX 운전면허증 바코드와 정보 불일치

  3. 불가리아 신분증 정보 불일치

no_face

Detect face failed: No face detected. At least one face must be detected in both selfie and ID image. Please retry.

제출된 이미지에 얼굴이 감지되지 않음

face_compare_underscore

The face doesn’t match. Please retry with another face image.

얼굴 비교 점수가 85점 이하

face_compare_fail

Failed to find a matching face. Please retry with another face image.

얼굴 비교를 하기 위한 유사 얼굴을 찾는데 실패(일치하는 얼굴이 없음)

face_detect_error

Failed to detect a face.

서버 에러

liveness_fail

Liveness fail. Please retry with another face image.

라이브니스 점수가 50점 이하

liveness_error

  1. Liveness fail: Face size is too small to be detected. Please retry

  2. Liveness fail: Face is too close to one or more borders. Please retry.

  3. Liveness fail: Interpupillary distance is too small. Please retry.

  4. Liveness fail: Absolute face size is too small. Please retry.

  5. Liveness fail: Face is cropped. Please retry.

  6. Liveness fail: Facial out-of-plane rotation angle is extremely large. Please retry

  7. Liveness fail: Relative face size is too small. Please retry.

라이브니스 통과 조건에 맞지 않음

bank_authentication_fail

The authentication code and account holder doesn't match.

1원 인증 코드 및 예금주명이 모두 일치하지 않는 경우

bank_authentication_code_fail

1 won authentication fail. The authentication code doesn't match.

1원 인증 코드가 일치하지 않는 경우

bank_authentication_name_fail

1 won authentication fail. The account holder doesn't match.

1원 인증 예금주명이 일치하지 않는 경우

Step 2 - Error Codes (400 error)

Error CodeMessageDescription

invalid_payload

Failed to parse the input data.

api call 할 때 발생하는 문제로 대부분 이미지가 없을 때 잘못 입력하였을 때 발생

invalid_request

Failed to find the project. Please check the project ID.

더 이상 제출이 유효한 프로젝트가 아님

invalid_face_image

Invalid face image. Please retry with another face image.

Selfie 이미지 파일의 경로가 잘못되었음

missing_parameters

Missing required parameters.

Input Data 필수 값이 들어오지 않았을 경우(Step2 - Input Data 참고)

invalid_address_image

Invalid address image. Please retry with another address image.

주소지 증명 이미지가 없거나 잘못된 경우

invalid_submission_id

Invalid submission ID error. Please check the submission ID.

Step 1에서 생성된 submission ID가 올바르게 입력되지 않음

no_submission

Fail to find the submission data. Please contact CS center.

DB 에서 submission 가져오기 실패

processed_submission

  1. This submission is already processed.

  2. {email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.

  1. Step2가 이미 진행된 submission(처리 완료 후 재시도 시)

  2. Approved Period 옵션에 의해 다시 KYC를 제출할 수 없을 때

rejected_submission

{email} has an existing approved submission. Not available to submit due to ‘approved period’ option to prevent duplication.

Rejected Period 옵션에 의해 다시 KYC를 제출할 수 없을 때

unauthorized

Invalid API key. Please check.

API키가 올바르지 않은 경우

missing_address

Missing address data information.

주소지 정보 없음(주소지 수집 옵션이 켜져 있을 때)

unexpected_error

Failed to submit KYC.

DB 저장 , webhook, email 전송 등의 최종 작업 실패 할 경우

verify_kor_error

The ID card you submitted is currently unable to proceed due to an error in the authenticity verification server. Please proceed with a different ID card or try again later.

한국 신분증 진위확인 서버 에러

invalid_bank_authentication

Failed to read bank authentication's data.

1원 송금 절차(PreStep2) 이 정상적으로 완료되지 않은 경우

missing_required_field

The account holder's name and the 1 won authentication code are required fields.

1원 인증 코드검증을 위한 필수 입력값 누락 (userOccupancyName, userOccupancyCode)

missing_required_field

1 won authentication fail. The account holder's name doesn't match.

1원 인증시 입력한 예금주명과 Step2 파라미터로 제출한 ‘userOccupancyName’ 이 일치하지 않는 경우

exceeded_72hour_limit

The submission is invalid because it has been more than 72 hours since Step1.

Step1 제출로부터 유효시간인 72시간이 경과한 경우(createTime 기준)

invalid_idType

The idType is required. This submission id failed to define idType in step1.

Universal 모드 사용하고 Step1 에서 idType 정의에 실패했는데, Step2 에 idType 파라미터 누락된 경우

Reject Comment Code

Reject Comment CodeMessageDescription

too_many_retry

Multiple invalid KYC attempts

Retry count가 3회로 올라갔지만 KYC가 승인되지 못함

timeout

KYC rejected due to timeout

Retry count가 1 이상이며 KYC Status가 'Incomplete'인 제출 건이 일정 시간 후 'Rejected'로 변경됨

duplicate_user

Identity has been determined to be the same duplicate as the previously approved one.

옵션 적용에 따라 중복된 사용자로 판명되어 신규 제출된 KYC를 거절

blacklistCountry

According to the policy, we do not accept KYC from {country}.

'Blacklist Country' 옵션이 적용되어 해당 국가에서 발급한 신분증으로 제출한 KYC를 거절

under_ageLimit

We do not accept KYC anyone under {age} years old.

'Age Limit' 옵션에 따라 설정된 연령 이하의 사용자가 제출한 KYC를 거절

invalid_acceptedID

Inacceptable ID type. Please resubmit with another ID, check the valid ID on the submission page.

'ID Type' 옵션에 따라 제출 받지 않기로 한 종류의 신분증을 거절함

id_image_invalidImage

ID document not detected. Please take a picture of your ID document.

제출된 신분증 이미지가 신분증이 아님

id_image_invalidId

Invalid ID document. Please resubmit with another ID document.

제출된 신분증이 유효하지 않음. 예) 생년만 나와있는 신분증

id_image_error

Fail to upload the ID image. Please resubmit the KYC process.

이미지 업로드 에러로 보이지 않음

id_image_badImage

Fail to read the ID image. Please take a clear picture of your ID document.

신분증 이미지 화질이 나빠 검수할 수 없음

id_info_dataMismatch

The entered information does not match with your ID document.

정보 수정이 불가능한 언어(한자, 키릴문자 등)이면서 신분증과 사용자 입력값이 다름

id_info_blacklist

According to the policy, we do not accept KYC from {country}.

매뉴얼 검수 단계에서 신분증의 발급 국가를 수정했고, 수정된 발급 국가가 Blacklist Country로 설정되어 있음

id_info_notOfAge

We do not accept KYC anyone under {age} years old.

매뉴얼 검수 단계에서 생년월일을 수정했고, 수정된 연령이 'Age Limit'에 설정된 값보다 낮음

address_image_invalidImage

Invalid proof of address. Proof of address must include your full name and address.

사용자의 이름과 주소가 다 나와있지 않아 유효한 주소지 문서가 아님

address_image_error

Fail to upload proof of address image. Please retry.

이미지 업로드 에러로 보이지 않음

address_image_badImage

Fail to read the image. Please take a clear picture of your proof of address.

주소지 증명 서류 이미지 화질이 나빠 검수할 수 없음

address_info_expiredDocument

Expired proof of address. The proof of address should be issued within 6 months.

주소지 증명 서류가 만료됨

address_info_dataMismatch

Entered information does not match with your proof of address.

정보 수정이 불가능한 언어(한자, 키릴문자 등)이면서 주소지 증명 서류와 사용자 입력값이 다름

other

other

매뉴얼 검수 단계에서 Agent가 입력한 안내 메세지

PreviousPOST/Address_codeNextISO Alpha3 국가코드

Last updated