Skip to main content
POST

인증

Authorization
string
header
필수

API 키를 Base64 인코딩하여 전달합니다. Username에 API 키를 입력하고 Password는 비워두세요.

본문

application/json

예금주를 조회할 계좌

bankCode
string
필수

금융결제원 3자리 표준 은행코드. 지원하는 은행은 예금주 조회 가이드를 참고하세요.

Pattern: ^\d{3}$
예시:

"088"

accountNumber
string
필수

계좌번호. 하이픈을 포함해도 됩니다. 하이픈을 뺀 숫자가 6~20자리여야 합니다.

Pattern: ^-*(?:\d-*){6,20}$
예시:

"1000000001"

amount
integer<int64>

금액 확인형 가상계좌의 입금 금액(원). 일반 계좌는 비워 두세요.

필수 범위: x >= 1

응답

조회 성공

예금주 단건 조회 결과

bankCode
string
필수

요청한 은행코드

accountNumber
string
필수

하이픈을 뗀 계좌번호

holderName
string
필수

예금주명