⌨️예금주 조회 API

은행코드 및 계좌번호를 이용하여 예금주 성명을 조회합니다.

Deprecated

이 문서는 더 이상 관리되지 않습니다.

PortOne 개발자센터를 이용해주세요.

예금주 성명을 은행계좌번호를 이용하여 획득합니다.

은행코드, 계좌번호를 이용해 해당 계좌의 예금주 명을 조회합니다.

GET https://api.iamport.kr/vbanks/holder

Query Parameters

Name	Type	Description
bank_code*	String	은행코드
bank_num*	String	계좌번호 숫자외 기호 포함 가능

200: OK

VbankHolderResponse

code * integer

응답코드

0이면 정상적인 조회, 0 이 아닌 값이면 message를 확인해봐야 합니다

message * string

응답메세지

code 값이 0이 아닐 때, '존재하지 않는 결제정보입니다'와 같은 오류 메세지를 포함합니다

response (VbankHolderAnnotation, optional)

VbankHolderAnnotation

bank_holder * string

예금주명

400: Bad Request bank_code가 누락된 경우

{
    // Response
}

401: Unauthorized 인증 Token이 전달되지 않았거나 유효하지 않은 경우

{
    // Response
}

404: Not Found 계좌정보 조회 실패

{
    // Response
}

Response Model Schema

{
  "code": 0,
  "message": "string",
  "response": {
    "bank_holder": "string"
  }
}

Swagger Test Link

https://api.iamport.kr/#!/vbanks/queryBankHolder