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를 반드시 입력해 주어야 합니다.
Input Data
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 입력 데이터를 필수로 요구합니다.
입력 데이터는 포맷에 맞춰 입력 되어야 합니다.
Output Data
success
<true, false> 1원송금 결과를 boolean 으로 반환
message
1원송금 성공 시 “success” 를 반환하며, 실패한 경우에는 retry 또는 error 에 대한 메세지를 반환
retryCode
1원송금 실패 시 retry code를 반환
retryCount
1원송금 실패 시 재시도 횟수를 반환하며 retry ≥ 5 일 경우 KYC rejected 처리
rejectComment
리젝 사유
Sample Response
인증코드 발송 성공에 대한 결과입니다.
인증코드 발송 실패에 대한 결과입니다.
인증코드 발송 실패 5회로, KYC rejected 된 건에 대한 결과입니다.
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를 제출하기 위한 샘플 요청 값 입니다.
Sample Response
PreStep 2 제출 실패 시 Retry code와 Retry message를 확인 할 수 있습니다.
제출 실패 시 동일한 submissionId를 사용하여 재시도를 할 수 있습니다.
재시도가 5회 이상 되었을 때 자동으로 Reject 되며 rejectComment를 확인할 수 있습니다.
Retry & Error Codes
Success Codes (200)
true
success
1원송금 및 인증코드 발송 완료
Retry Codes (200)
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)
false
too_many_retry
5
재시도 횟수 5회 초과로 KYC rejected 되었습니다.
Error Codes (400)
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