Konaplate logo

API Documentation

All API

Service


카드에 연결된 가상계좌 조회Sync

Version: v1


Version: v1

POST

/api/v1/card/virtual-account/inquiry

카드에 연결되어있는 가상계좌 번호를 조회합니다.

Request Headers


X-KM-User-AspId

string

Required

Length : 15

ASP ID

  • ID given to the service provider.
  • The ID is provided at the time of contract.

X-KM-Correlation-Id

string

Required

Length : 20

Transaction number for tracking trasncription

  • Form : yyMMddHHmiSS-xxxxxxx
  • xxxxxxx : 7digit, Hex String

X-KM-Access-Key

string

Conditional

Length : 40

Access Key created by Project

  • Excluding the case for Callback API

X-KM-Crypto-Key-Id

string

Optional

Length : 32

Data Encryption/Decryption Key ID

  • Given ID from creating the service provider's project
  • Required value when requesting data encryption.

X-KM-Tran-Token

string

Required

Length : 66

Refer to Common header information- X-KM-Tran-Token Guide page

X-KM-Tran-Time

string

Required

Length : 16

Client Request Time

  • Form : YYYYMMDDHH24MISS

X-KM-Time-Zone

string

Required

Length : 3

International Standard Time (UTC, KST, ...)

Request Parameters

Encrypted|
Check out
Guidelines
for more information.

cardNo

string

Required

Length : 16

카드번호

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

Encrypted|
Check out
Guidelines
for more information.

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

200 - 성공 테스트


200 - 성공 테스트
400 - 입력 파라미터 오류입니다.
400 - 필수 파라미터가 누락되었습니다.
400 - 카드번호를 잘못 입력하였거나 없는 정보입니다.
400 - 매핑된 가상계좌 번호가 없음.
Loading ...

Request

Loading...

Response

Click Try It!
to start a Request and see the Response here!


User RegisterSearch for Member InformationMember Password Reset and ChangeMember Information ChangeMembership CancellationChecking Log in ID checkActivation of Dormant MemberSearch for Terms and Conditions ListTerms and Conditions Agreement/WithdrawalCI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회Financial Institution List InquiryReal Name Verification for Account holderAuthentication code generation before ARS authentication.Bank account registration via PGSearch for Account Registration StatusBalance Limit Increase(Individual card)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제Issuance of Disposable TokenChargeCancellation of ChargeChecking Result of Charge & Cancellation of ChargeChecking Transaction HistoryApplication for Issuance and Delivery of Prepaid CardCancellation of Card ApplicationReissuance of Prepaid Card (Replacement Issuance)Reissuance & Renewal of Prepaid Card to be ExpiredSearch for Card Delivery StatusSearch for Mobile Card Application Information Linkable to Physical CardPhysical Card RegistrationSearch for CardUnregistered card inquiryModification of the Card’s StateDiscarding a CardBalance Limit Increase(Individual card)Balance Limit Increase(Coporate card)Inquiry of Coporate Card Identification StatusApplying For Income Tax DeductionInquiry of Card Tax Deduction StatusCard-User Mapped InquiryCard Product ID Inquiry주카드 설정카드에 연결된 가상계좌 조회User RegisterSearch for Member InformationMember Password Reset and ChangeMember Information ChangeMembership CancellationChecking Log in ID checkActivation of Dormant MemberSearch for Terms and Conditions ListTerms and Conditions Agreement/WithdrawalCI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회Financial Institution List InquiryReal Name Verification for Account holderAuthentication code generation before ARS authentication.Bank account registration via PGSearch for Account Registration StatusBalance Limit Increase(Individual card)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제