본문 바로가기

개발자용 API

계좌 예금주 조회 API

은행과 계좌번호를 보내면 그 계좌의 예금주 실명을 돌려줍니다. 환불·정산·지급 계좌를 등록할 때 예금주가 맞는지 송금 전에 확인하세요.

  • 오송금·환불 사고를 사전에 차단
  • 고객 이름과 계좌 명의 자동 대조
  • 확인 전화·문자 수작업 제거

서비스·시스템에 연동하는 기업·개발자를 위한 API입니다. 인증키로 호출하고 사용한 만큼 포인트가 차감됩니다.

무료로 가입하고 인증키 받기 개발 문서 보기 화면에서 체험하기

이런 서비스에 연결합니다

  • 정산·지급 계좌 등록판매자·파트너가 등록한 정산 계좌의 예금주가 가입자 이름과 같은지 확인합니다.
  • 환불 계좌 검증고객이 입력한 환불 계좌의 예금주를 미리 확인해 오입금과 재송금을 줄입니다.
  • 급여·지원금 지급 전 점검대량 지급 전에 계좌별 예금주를 확인해 반송될 지급을 미리 걸러 냅니다.

가격과 이용 조건

  • 조회 1건당 60P · 성공한 조회만 과금
  • 최소 1회 포인트 충전(결제) 후 이용할 수 있는 API입니다.
  • 서비스·시스템에 연동하는 기업·개발자용 API입니다. 회원가입 후 발급되는 인증키로 호출합니다.
  • 은행 코드 또는 은행명 중 하나와 계좌번호를 보냅니다. 은행명은 은행코드 조회 API의 이름을 그대로 씁니다.
  • 계좌 소유자 확인 목적으로만 사용하고, 조회 결과의 보관·이용은 귀사의 개인정보 처리 기준을 따르세요.
  • 해당 은행의 점검 시간에는 조회할 수 없습니다.

요금 정책 · 처음 연동 가이드

연동 예제

인증키는 Authorization: Bearer 헤더로 보냅니다. 서버에서만 호출하고 인증키를 브라우저·앱에 넣지 마세요.

cURL
curl -X POST "https://apick.app/rest/account_realname" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --form-string "bank_name=국민" \
  --form-string "account_num=00000123456789"
Node.js (18 이상) 
const form = new FormData();
form.append("bank_name", "국민");
form.append("account_num", "00000123456789");

const response = await fetch("https://apick.app/rest/account_realname", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
});
const { data, api } = await response.json();
if (data.error) throw new Error(data.error); // 실패는 과금되지 않습니다
console.log(data, api.cost);

응답 예시

{
  "data": {
    "은행코드": "004",
    "은행명": "국민",
    "계좌번호": "00000123456789",
    "계좌실명": "홍길동",
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 60,
    "ms": 840
  }
}

예시 값은 가상의 계좌입니다.

오류 해결

HTTP 상태 → api.success → data.error → api.cost 순서로 확인하세요. 실패 응답은 과금되지 않습니다.

  • data.success = 0HTTP 200

    조회에 실패했습니다. 은행·계좌번호를 확인하고 data.error 문구를 표시하세요. 과금되지 않습니다.

  • data.success = 3HTTP 200

    처리 시간이 초과됐습니다. 잠시 후 다시 요청하세요. 과금되지 않습니다.

  • 무료 포인트로 사용할 수 없는 서비스입니다.HTTP 200

    최소 1회 충전(결제) 후 이용할 수 있는 API입니다. 충전 후 같은 요청을 다시 보내세요.

  • 유효하지 않은 API키 입니다.HTTP 401

    Authorization: Bearer 헤더의 인증키를 확인하세요. 인증키는 마이페이지에서 확인합니다.

  • 허용되지 않은 IP주소 입니다.HTTP 401

    마이페이지의 허용 IP 설정과 요청을 보내는 서버 IP를 확인하세요.

  • 사용 가능한 포인트이 부족합니다.HTTP 200

    HTTP 200이어도 data.error가 있으면 실패입니다. 포인트를 충전한 뒤 다시 요청하세요. 이 응답은 과금되지 않습니다.

전체 응답 항목과 오류 코드는 개발 문서에 있습니다.

키 발급 → 예제 실행 → 첫 성공까지 몇 분이면 됩니다.

무료로 가입하기 개발 문서 보기