Post/Submission/validationAccount (PreStep2)

PreStep2

  • PreStep2는 ‘계좌인증 - 1원인증’ 옵션을 을 사용하는 경우에만 호출합니다.

  • 1원인증은 총 2개의 단계로 나뉘어지며, PreStep2 에서는 1원입금 및 코드발송을 진행하고 기존 Step2에서는 코드 검증을 진행합니다. (Step2 추가 parameter 확인)

  • PreStep2는 Step1 진행 완료 후 호출하며, 반드시 Step2 보다 선행되어야 합니다.

  • PreStep2 에서는 입력한 은행코드 및 계좌번호에 인증코드와 함께 1원이 입금됩니다.

  • 입금자명의 앞 숫자 3자리가 인증코드이며, 이를 Step2 호출 시 Input Data 로 함께 제출합니다.

  • 계좌번호, 은행코드는 기호 없이 오직 숫자만 입력가능하며 String 타입으로 입력합니다.

Request URL

  • PreStep 2를 제출하는 방법에 대해 설명 합니다.

  • URL과 x-api-key를 반드시 입력해 주어야 합니다.

curl -X POST "<https://rest-api.argosidentity.com/v3/submission/validationaccount>" \\
-H "x-api-key: {yourAPIKey}" \\

Input Data

Sample Request

  • Step 1에서 전달 받은 ID check 데이터의 고유 식별 ID(submissionId)를 PreStep 2 에서 반드시 입력 해야 합니다.

  • SubmissionId, requestType, userName, bankCode, accountNumber 입력 데이터를 필수로 요구합니다.

  • 입력 데이터는 포맷에 맞춰 입력 되어야 합니다.

curl --location --request POST '<https://rest-api.argosidentity.com/v3/submission/validationaccount>' \\
--header 'x-api-key: {yourAPIKey}' \\
--header 'Content-Type: application/json' \\
--data-raw '{
    "submissionId": "{submission_Id}",
    "requestType": "occupancy",
    "userName": "{account_holder_name}",
    "bankCode": "{bank_code}",
    "accountNumber": "{1111222333444}"
}'

Output Data

Sample Response

  • 인증코드 발송 성공에 대한 결과입니다.

{
	statusCode: 200,
	message : "success",
	success : true
}
  • 인증코드 발송 실패에 대한 결과입니다.

{
	statusCode: 200,
	message : "This bank code is invalid. Please check bank code.",
	retryCode: "invalid_bank_code",
	success : false,
	retryCount : 2
}
  • 인증코드 발송 실패 5회로, KYC rejected 된 건에 대한 결과입니다.

{
	statusCode: 200,
	rejectComment: "too_many_retry",
	success : false,
	retryCount : 5
}

Bank Code

PreStep2 Retry

PreStep 2에서 제출 실패 시 재시도를 위해 아래의 설명을 참고해 주세요.

Request URL

  • PreStep 2를 제출하는 방법에 대해 설명 합니다.

  • URL과 x-api-key를 반드시 입력해 주어야 합니다.

Sample Request

PreStep 2를 제출하기 위한 샘플 요청 값 입니다.

curl --location --request POST '<https://rest-api.argosidentity.com/v3/submission/validationaccount>' \\
--header 'x-api-key: {yourAPIKey}' \\
--header 'Content-Type: application/json' \\
--data-raw '{
    "submissionId": "{submission_Id}",
    "requestType": "occupancy",
    "userName": "{account_holder_name}",
    "bankCode": "{bank_code}",
    "accountNumber": "{1111222333444}"
}'

Sample Response

  • PreStep 2 제출 실패 시 Retry code와 Retry message를 확인 할 수 있습니다.

  • 제출 실패 시 동일한 submissionId를 사용하여 재시도를 할 수 있습니다.

  • 재시도가 5회 이상 되었을 때 자동으로 Reject 되며 rejectComment를 확인할 수 있습니다.

{
	statusCode: 200,
	message : "This bank code is invalid. Please check bank code.",
	retryCode: "invalid_bank_code",
	success : false,
	retryCount : 2
}
{
	statusCode: 200,
	rejectComment: "too_many_retry",
	success : false,
	retryCount : 5
}

Retry & Error Codes

Success Codes (200)

Retry Codes (200)

Rejected Codes (200)

Error Codes (400)

Last updated