API 문서
전체 API
서비스
카드에 연결된 가상계좌 조회동기
버전: v1
버전: v1
/api/v1/card/virtual-account/inquiry
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
accountNo
string
필수
최소 : 1 , 최대 : 20
가상 계좌 번호
bankCode
string
필수
길이 : 3
은행코드
connectType
string
필수
길이 : 8
가상 계좌 연결 방식
-FIXATION : 고정 연결 방식
-ROTATION : 로테이션 연결 방식
status
string
필수
길이 : 10
가상 계좌 상태
- ACTIVE : 활성화
- INACTIVE : 비활성화
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
400
에러 코드
000_002
메시지
Invalid input parameter.
설명
입력 파라미터 오류입니다.
400
에러 코드
000_003
메시지
Missing required values.
설명
필수 파라미터가 누락되었습니다.
400
에러 코드
003_029
메시지
Card not found
설명
카드번호를 잘못 입력하였거나 없는 정보입니다.
400
에러 코드
003_067
메시지
Not found virtual account.
설명
매핑된 가상계좌 번호가 없음.
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.