예금주 단건 조회
은행코드와 계좌번호로 예금주명 한 건을 조회합니다. 발급자 등록과 공동인증서가 필요 없고, 요청자 관리번호도 쓰지 않습니다. 입금 금액이 정해진 가상계좌는 amount에 금액을 넣어야 조회합니다.
여러 계좌를 한 번에 조회하려면 일괄 조회 API를 쓰세요. 예금주 조회 가이드
POST
/
v1
/
bankAccountHolders:inquire
curl --request POST \
--url https://xapi.bolta.io/v1/bankAccountHolders:inquire \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"bankCode": "088",
"accountNumber": "1000000001"
}
'{
"bankCode": "088",
"accountNumber": "1000000001",
"holderName": "홍길동"
}인증
API 키 뒤에 콜론을 붙여 Base64로 인코딩해 헤더에 넣으세요. Username에 API 키를 입력하고 Password는 비워두세요.
본문
application/json
예금주를 조회할 계좌
계좌번호. 하이픈을 포함해도 됩니다. 하이픈을 뺀 숫자가 6~20자리여야 합니다.
Pattern:
^-*(?:\d-*){6,20}$예시:
"1000000001"
금액 지정형 가상계좌의 입금 금액(원). 일반 계좌는 비워 두세요.
필수 범위:
x >= 1curl --request POST \
--url https://xapi.bolta.io/v1/bankAccountHolders:inquire \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"bankCode": "088",
"accountNumber": "1000000001"
}
'{
"bankCode": "088",
"accountNumber": "1000000001",
"holderName": "홍길동"
}