API Documentation
All API
Service
카드에 연결된 가상계좌 조회Sync
Version: v1
Version: v1
/api/v1/card/virtual-account/inquiry
Request Headers
Request Parameters
Response Headers
X-KM-Correlation-Id
string
Required
Length : 20
Transaction number for tracking trasncription
- Form : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7digit, Hex String
X-KM-Crypto-Key-Id
string
Optional
Length : 32
Data encryption/decryption key ID
- Given ID from creating the service provider's project
- If it is passed as a callback, the first key issued among the keys issued to the service provider is used.
Response Parameters
accountNo
string
Required
Min : 1 , Max : 20
가상 계좌 번호
bankCode
string
Required
Length : 3
은행코드
connectType
string
Required
Length : 8
가상 계좌 연결 방식
-FIXATION : 고정 연결 방식
-ROTATION : 로테이션 연결 방식
status
string
Required
Length : 10
가상 계좌 상태
- ACTIVE : 활성화
- INACTIVE : 비활성화
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success.
Description
성공
400
Error code
000_002
Message
Invalid input parameter.
Description
입력 파라미터 오류입니다.
400
Error code
000_003
Message
Missing required values.
Description
필수 파라미터가 누락되었습니다.
400
Error code
003_029
Message
Card not found
Description
카드번호를 잘못 입력하였거나 없는 정보입니다.
400
Error code
003_067
Message
Not found virtual account.
Description
매핑된 가상계좌 번호가 없음.
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!