POST/Submission/Step2

Request URL

curl -X POST "https://rest-api.argosidentity.com/v3/submission/step2"
-H "x-api-key: {yourAPIKey}"
-form ...
  • 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는 Retry/Error/Reject Codes 페이지에서 확인해 주세요.

  • faceImage의 표준 권장 사양은 960 x 720 픽셀 입니다.

Input Data

*이 붙은 것은 필수 파라미터 입니다.

진위확인 Input Data

진위 확인은 신분증의 발급 국가와 신분증 타입에 따라 필요한 파라미터가 달라집니다.

Sample Request 1

curl --location --request POST 'https://rest-api.argosidentity.com/v3/submission/step2' \
--header 'x-api-key: {YOUR_API_KEY}' \
--form 'faceImage=@"/C:/Users/face.jpg"' \
--form 'name="홍길동"' \
--form 'nationality="KOR"' \
--form 'date_of_birth="1998-11-11"' \
--form 'date_of_issue="2016-11-11"' \
--form 'submissionId="d76h19l46m****"' \
--form 'identity_number="981112-1******"' \
--form 'gender="male"'

Sample Request 2

var myHeaders = new Headers();
myHeaders.append("x-api-key", "{YOUR_API_KEY}");

var formdata = new FormData();
formdata.append("faceImage", fileInput.files[0], "/C:/Users/face.jpg");
formdata.append("name", "홍길동");
formdata.append("nationality", "KOR");
formdata.append("date_of_birth", "1998-11-11");
formdata.append("date_of_issue", "2016-11-11");
formdata.append("submissionId", "d76h19l46m****");
formdata.append("identity_number", "981112-1******");
formdata.append("gender", "male");

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: formdata,
  redirect: 'follow'
};

fetch("https://rest-api.argosidentity.com/v3/submission/step2", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

Output Data

Sample Response - Approved

{
    "faceSimilarityScore": 99,
    "livenessScore": 74,
    "kycStatus": "approved",
    "retryCount": 0
}

Sample Response - Rejected

{
    "livenessScore": 74,
    "kycStatus": "rejected",
    "retryCount": 3
}

Sample Response - Pending

{
    "faceSimilarityScore": 99,
    "livenessScore": 74,
    "kycStatus": "pending",
    "retryCount": 0
}

Sample Response - Incomplete

{
    "retry": [
        {
            "retryCode": "face_compare_fail",
            "retryMsg": "Face compare failed: no matching face"
        }
    ],
    "kycStatus": "incomplete",
    "retryCount": 1
}

Retry & Error Codes

주의사항

얼굴 비교가 원활하게 되기 위해서는 셀피 이미지에서 얼굴의 비율이 적절해야 합니다. 전체 이미지에서 얼굴이 차지하는 비율이 너무 크거나, 너무 작으면 얼굴 비교에 실패할 수 있습니다. 아래의 이미지 아르고스 라이브폼에서 사용하는 가이드 라인과 적절한 비율의 얼굴 사진, 적절하지 못한 비율의 얼굴 사진 예시입니다.

Last updated