본문으로 이동
개요

예금주 조회 API지급, 거래처 운영팀

금액이 정해진 가상계좌까지, 예금주를 확인하세요.

지급 전에 확인해야 할 계좌가 일반 계좌만 있는 것은 아닙니다. 은행과 계좌번호로 조회하고, 지정 금액이 필요한 가상계좌도 함께 확인하세요.

01

일반 계좌와 금액 지정형 가상계좌.

계좌의 확인 방식에 맞춰 조회하세요. 금액 지정형 가상계좌는 지정된 금액을 알고 있어야 합니다.

  • 일반 계좌

    은행과 계좌번호로 예금주명을 확인합니다.
  • 금액 지정형 가상계좌

    은행, 계좌번호와 함께 지정 금액을 전달해 예금주명을 확인합니다.

금액 지정형 가상계좌 조회에는 정확한 지정 금액이 필요합니다.

02요청과 응답

요청 하나가 결과로 돌아오기까지

내 서비스와 볼타 API, 기관 사이를 오가는 순서입니다. 인증서 처리와 기관 연결은 볼타가 맡습니다.

03

인증서 준비 없이, 지급 전 확인부터.

발급자 등록이나 공동인증서 없이 시작합니다. 계좌 등록 단계나 지급 직전에 붙이고, 예금주를 확인한 계좌에만 요금을 지불하세요.

  • 공동인증서 없이

    발급자 등록 절차도 필요 없습니다.
  • 성공한 조회에만

    예금주를 찾지 못하면 차감하지 않습니다.

04도입 조건과 요금

시작하기 전에 확인하세요.

예금주 조회

예금주를 돌려준 계좌만 차감합니다. 예금주를 못 찾은 계좌, 조회 실패, 한도 초과는 차감하지 않습니다. 테스트 키는 언제나 무료입니다.

성공 조회 계좌당 50원

예금주를 찾지 못했거나 조회에 실패한 계좌는 과금하지 않습니다. 구독 플랜 제한은 없습니다.

  • 금액 지정형 가상계좌는 정확한 지정 금액이 필요합니다.
  • 지원 은행은 공식 문서에서 확인하세요.

중복 과금 제외는 한 요청 안에서만 적용합니다. 일반 계좌는 같은 은행과 계좌번호당 한 번, 금액 지정형 가상계좌는 고유한 금액마다 차감하며, 별도 재요청은 다시 과금합니다.

포인트 충전 방식 보기 (새 창)

05AI와 연동 시작

쓰던 AI 도구로 연동을 시작하세요.

공식 문서, 준비 조건, 테스트할 내용을 담았습니다. 프롬프트를 복사해 현재 프로젝트를 다루는 AI 도구에 전달하세요.

예금주 조회 API: 연동 프롬프트

공식 문서, 상품 범위, 테스트 방법

프롬프트 내용 보기
현재 프로젝트에 이 볼타 API를 연동해 주세요.

금액이 정해진 가상계좌까지, 예금주를 확인하세요.

공식 문서를 먼저 읽고 현재 프로젝트의 언어와 구조에 맞는 구현 계획을 제안하세요.

https://docs.bolta.io/llms.txt

https://docs.bolta.io/docs/api-introduction/quickstart

https://docs.bolta.io/docs/api-introduction/bank-account-holder

https://docs.bolta.io/docs/api-introduction/pricing

선행 조건과 범위:

- 금액 지정형 가상계좌는 정확한 지정 금액이 필요합니다.

- 지원 은행은 공식 문서에서 확인하세요.

예금주 조회: 성공 조회 계좌당 50원

예금주를 찾지 못했거나 조회에 실패한 계좌는 과금하지 않습니다. 구독 플랜 제한은 없습니다.

API 키는 서버 환경변수로 참조하고 대화창에 비밀 키를 요청하지 마세요. 문서의 테스트 키와 입력으로 먼저 검증하세요.

테스트 목표: 일반 계좌와 금액 지정형 가상계좌의 성공, 금액 불일치, 조회 실패를 테스트한다. 한 요청 안의 중복과 별도 재요청의 과금을 구분한다.

문서에 없는 기능이나 응답을 추정하지 마세요. 확인이 필요한 부분을 표시하고 테스트 결과와 운영 전환 준비 사항을 정리하세요.

06FAQ

도입 전에 많이 묻는 질문

연동 방법과 오류 코드는 API 문서에 정리돼 있습니다.

API 문서 보기 (새 창)
같은 계좌를 다시 조회하면 요금이 발생하나요?

네. 요청을 다시 보내면 다시 과금합니다. 일반 계좌는 한 요청 안에서 같은 은행과 계좌번호가 중복된 경우에만 한 번 차감합니다. 금액 지정형 가상계좌는 고유한 금액마다 차감합니다.

가상계좌의 지정 금액을 모르면요?

금액 지정형 가상계좌 조회에는 정확한 지정 금액이 필요합니다.

계약 없이 오늘부터 연동을 시작하세요.

공동인증서도, 발급자 등록도 필요 없습니다. 키를 발급하면 바로 호출하고 예금주를 확인한 계좌에만 요금을 내세요.

도입 범위를 먼저 상의하고 싶다면API 도입 상담