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.argoskyc.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에서 전달 받은 KYC 데이터의 고유 식별 ID(submissionId)를 PreStep 2 에서 반드시 입력 해야 합니다.

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

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

curl --location --request POST '<https://rest-api.argoskyc.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.argoskyc.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회를 초과하였습니다.