API 문서
전체 API
서비스
계좌 예금주 실명 검증동기
버전: v1
버전: v1
/api/v1/bankaccounts/user/valid
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success
설명
성공
400
에러 코드
002_001
메시지
Bank account is length over limit or including not-number digit.
설명
계좌의 길이가 잘못되었거나 숫자가 아닌 값을 포함하고 있습니다.
400
에러 코드
002_002
메시지
No response name check api.
설명
PG사와 통신 오류가 발생하여 계좌의 예금주 실명 조회 실패 했습니다.
400
에러 코드
002_003
메시지
Names are not matched.
설명
계좌의 예금주 실명과 회원의 실명이 다릅니다.
400
에러 코드
002_004
메시지
Bank is not valid to check account info.
설명
은행 업무 개시 전으로 계좌 정보 수신 불가능 합니다.
400
에러 코드
002_005
메시지
User info not found.
설명
입력한 회원 정보(생년월일)로 은행 계좌 정보를 찾을 수 없습니다.
400
에러 코드
002_006
메시지
Bank is not valid.
설명
은행의 서비스 가능 시간이 아님에 따라(시스템 점검/야간 지연 등) 계좌 정보 확인 불가능 합니다.
400
에러 코드
002_007
메시지
Bank account is not found.
설명
입력한 계좌 번호로 은행 계좌를 찾을 수 없습니다.
400
에러 코드
002_008
메시지
Bank account's status is not valid.
설명
거래 불가 상태의 계좌입니다.
400
에러 코드
002_009
메시지
Bank account is not valid for holder's name check.
설명
입력한 계좌는 실명 확인 용도로 사용할 수 없습니다.
전체 보기
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.