POST/Submission/Step2
Last updated
Was this helpful?
Last updated
Was this helpful?
Step2에서는 Step1에서 추출된 데이터를 토대로 입력 데이터를 작성하여 제출합니다.
Step2는 얼굴 비교, 신분증에서 추출된 데이터와 사용자 입력 데이터 비교, 주소지 수집 및 증명 등을 진행하는 단계입니다.
Step2는 form-data 형식으로 제출해야 합니다.
Step2에서는 얼굴사진을 총 3번(처음 1번 + retry 2) 보낼 수 있습니다. Step 2의 첫 번째 시도가 진행되었다면, Step 1 시작 지점부터 24시간 내에 ID check 라이브폼 제출이 완료되어야 합니다. (Step2 진행 이력이 있지만 KYC 결과가 나지 않은 submission은 24시간 후 Reject 됩니다.)
제출된 Submission의 상세 정보는 , 또는 Get submission API로 확인 할 수 있습니다.
주소지 수집 옵션이 설정되어 있으면 globalCode, compoundCode, formatted_address, address_input, address_detail 값을 요구합니다. 해당 값을 구하기 위해 POST/Address_code API를 사용합니다. globalCode, compoundCode, formatted_address 값 중 하나는 반드시 있어야 합니다.
address_input은 사용자가 직접 입력한 주소 address_detail은 상세주소를 나타냅니다. 필수로 요구하는 값은 아닙니다.
Step1에서 생성된 Submission ID를 Step2에서 반드시 입력 해야 합니다.
SubmissionId, faceimage, name, date_of_birth 입력 데이터를 필수로 요구합니다.
Retry code와 error code는 페이지에서 확인해 주세요.
faceImage의 표준 권장 사양은 960 x 720 픽셀 입니다.
*이 붙은 것은 필수 파라미터 입니다.
*submissionId
string
step 1으로 받은 제출된 고유 ID
*faceImage
file
하나의 얼굴을 보여주는 셀피 사진. 여러 명의 얼굴이 감지되면 재시도로 응답.
(권장 용량: 1mb, 최대: 2mb)
*name
string
First Name Last Name을 구분하지 않은 Fullname(First_Name & Last_Name)의 형태
*date_of_birth
string
YYYY-MM-DD
gender
string
<male, female>
nationality
string
ISO alpha 3 형식의 국적
identity_number
string
사용자 고유의 식별번호
license_number
string
한국 운전면허증의 면허번호 12자리 12자리 숫자(12-34-567890-12 ) or 지역명과 10자리 숫자(서울-12-345678-90)
document_number
string
문서 고유번호 (여권번호, 해외 운전면허 번호 등)
serial_number
string
한국 운전면허증의 고유한 6자리 일련번호
date_of_issue
string
YYYY-MM-DD 형식의 신분증 발급일자
date_of_expiry
string
YYYY-MM-DD 형식의 신분증 만일자
addressImage
file
주소지 증명 문서 사진 파일 (권장 용량: 1mb, 최대: 2mb)
address_street
string
도로 주소
address_city
string
도시
address_state
string
주
address_country
string
ISO 3 형식의 국가코드
address_zipcode
string
우편번호
globalCode
string
전체 주소에 대한 상세 코드 값 (예. 8Q98HX4FvmfRC)
compoundCode
string
국가 및 도시와 상세주소 코드 값 (예. HX4F+RC Seoul, South Korea)
formatted_address
string
정형화된 주소 값
address_input
string
사용자 입력 주소 값 (사용자가 직접 주소를 입력하고 싶은 경우 사용)
address_detail
string
사용자 입력 상세 주소 값 (건물 이름만 있을 때 정확한 주소를 기재하기 위해 사용)
userOccupancyCode
string
PreStep2(1원 계좌 인증)을 진행한 경우, 1원 입금 시 받은 인증 코드 3자리 (ex. 123테스트)
userOccupancyName
string
PreStep2(1원 계좌 인증)을 진행한 경우, 1원 입금 시 받은 예금주 성명
idType
string
(Universal mode 옵션 사용 시) Step1 에서 OCR 인식 실패로 idType 이 ‘any’ 로 반환 된 경우, Step2 진행 시 idType 을 필수 제출 유효한 값 : passport, government_id, drivers_license, residence_permit, vehicle_registration certificate, visa, aadhaar, pancard
진위 확인은 신분증의 발급 국가와 신분증 타입에 따라 필요한 파라미터가 달라집니다.
KOR
government_id
name, date_of_birth, identity_number
KOR
drivers_license
date_of_birth, license_number, serial_number
KOR
passport
name, date_of_birth, document_number, date_of_issue, date_of_expiry
KOR
residence permit
identitiy_number, date_of_issue
USA, CAN, MEX
drivers_license
name, date_of_birth, gender, date_of_expiry, date_of_issue, dcoument_number
kycStatus
<pending, approved, rejected, incomplete> Pending: KYC 제출 완료 후 수동 검수 Icomplete: 부족한 KYC 데이터로 인해 제출이 완료되지 않음
*kycStatus가 ‘pending’, ‘approved’나 ‘rejected’ 상태로 변할때까지 step 2의 재시도를 하길 추천
faceSimilarityScore
신분증의 사진과 셀카 사진의 얼굴 유사도 점수, 100에 가까울수록 두 얼굴이 일치할 확률이 커짐(0~100).
livenessScore
셀피 이미지 속 얼굴이 실제 인물인지 여부를 평가하며, 점수가 100에 가까울수록 이미지는 (영상이나 이미지의 이미지가 아닌)실제 인물 사진일 가능성이 높아짐(0~100).
verificationResult
<success, fail>
retryCount
Step 재시도 횟수, 2번을 넘을 경우 KYC는 거절됨.
retry
kycStatus가 ‘incomplete'인 경우에, 재시도 사유를 retry code와 retry message로 보여줌.
recognized_IdType
Universal mode 사용 시, Step1 에서 OCR 인식 성공 한 경우 정의된 idType
얼굴 비교가 원활하게 되기 위해서는 셀피 이미지에서 얼굴의 비율이 적절해야 합니다. 전체 이미지에서 얼굴이 차지하는 비율이 너무 크거나, 너무 작으면 얼굴 비교에 실패할 수 있습니다. 아래의 이미지 아르고스 라이브폼에서 사용하는 가이드 라인과 적절한 비율의 얼굴 사진, 적절하지 못한 비율의 얼굴 사진 예시입니다.
Retry code와 error code는 페이지에서 확인해 주세요.