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

Parameter
Type
Required
Description

submissionId

string

*required

setp 1에서 전달 받은 제출된 KYC 데이터의 고유 식별 ID

requestType

string

*required

진행할 계좌 인증의 유형 선택. (현재는 1원 인증만 가능)

userName

string

*required

예금주 성함

bankCode

string

*required

은행 코드 숫자 3자리 (*하단의 은행코드표 참고)

accountNumber

string

*required

계좌번호 숫자만 입력 ( ‘-’ 또는 공백 제외)

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

Response
Description

success

<true, false> 1원송금 결과를 boolean 으로 반환

message

1원송금 성공 시 “success” 를 반환하며, 실패한 경우에는 retry 또는 error 에 대한 메세지를 반환

retryCode

1원송금 실패 시 retry code를 반환

retryCount

1원송금 실패 시 재시도 횟수를 반환하며 retry ≥ 5 일 경우 KYC rejected 처리

rejectComment

리젝 사유

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

은행코드
은행명
은행코드
은행명

002

산업은행

067

중국건설은행

003

기업은행

071

우체국

004

국민은행

081

하나은행

007

수협은행

088

신한은행

011

농협은행

089

K뱅크

012

지역농축협

090

카카오뱅크

020

우리은행

20

유안타증권

023

SC은행

218

KB증권

027

한국씨티은행

238

미래에셋증권

031

대구은행

240

삼성증권

032

부산은행

243

한국투자증권

034

광주은행

247

NH투자증권

035

제주은행

261

교보증권

037

전북은행

262

하이투자증권

039

경남은행

263

현대차증권

045

새마을금고중앙회

264

키움증권

048

신용협동조합중앙회

265

이베스트투자증권

050

상호저축은행

266

SK증권

054

HSBC

267

대신증권

055

도이치뱅크

269

한화투자증권

057

제이피모건체이스은행

270

하나금융투자

058

미즈호은행

278

신한금융투자

059

엠유에프지은행

279

DB 금융투자

060

BOA은행

280

유진투자증권

062

중국공상은행

287

메리츠종합금융증권

064

산림조합중앙회

291

신영증권

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)

success
message
설명

true

success

1원송금 및 인증코드 발송 완료

Retry Codes (200)

success
message
retryCode
retryCount
설명

false

This bank code is invalid. Please check bank code

invalid_bank_code

{count}

은행코드가 유효하지 않습니다. 은행 코드를 확인해주세요.

false

Fail to verify the account.

failed_to_verify

{count}

계좌 검증에 실패했습니다.

false

This account is not able to deposit.

unable_to_deposit

{count}

입금 가능한 계좌가 아닙니다.

false

Transfer is currently not possible.

unable_to_Transfer

{count}

현재 이체가 불가능합니다.

false

The transfer is being processed.

transfer_is_processing

{count}

현재 이체 처리중입니다.

false

fail to send code.

fail_to_request

{count}

그 외 은행에서 정의하지 않은 기타 에러

Rejected Codes (200)

success
rejectComment
retryCount
설명

false

too_many_retry

5

재시도 횟수 5회 초과로 KYC rejected 되었습니다.

Error Codes (400)

success
message
errorCode
설명

false

data parsing error. please check input data.

invalid_data_format

Input 데이터의 형식이 올바르지 않습니다. 확인 후 다시 시도하세요.

false

required field is missing.

missing_required_field

필수 입력값이 누락되었습니다. Input 데이터를 확인해주세요.

false

invaild request type.

invalid_request_type

request type이 올바르지 않습니다. 1원인증은 ‘requestType: occupancy’ 을 입력해주세요.

false

The account verification option is not in use.

not_using_option

‘계좌 인증 옵션’을 사용중인 프로젝트가 아닙니다. 프로젝트 옵션을 확인해주세요.

false

This submission is not invalid.

invalid_submission

유효한 submission이 아닙니다. Step1이 미완료 되었거나 이미 reject 된 submission 입니다.

false

fail to request:+ {error messga}

fail_to_request

은행 서버로의 1원 송금 요청에 실패하였습니다.

false

db processing error: + {error messga}

db_processing_error

데이터 처리 중 문제가 발생하였습니다.

false

This account has exceeded the limit of 10 transfers per day.

exceeded_transfer_limit

동일한 계좌로 1일 이체한도인 10회를 초과하였습니다.

Last updated