계좌조회api 시작 가이드 2026

1. 계좌조회api란?

계좌조회api는 농협, 국민, 우리, 기업, 신한은행의 빠른계좌(간편조회) 거래내역을 프로그래밍 방식으로 조회할 수 있는 REST API 서비스입니다. 기존에는 수동으로 은행 앱에 접속해서 거래내역을 확인해야 했지만, 계좌조회api를 사용하면 자동화할 수 있습니다.

계좌조회api의 핵심 기능은 다음과 같습니다:

• 계좌 거래내역 조회 API: 특정 계좌의 입출금 내역을 날짜별로 조회
• 자동 입금확인 API: 신규 입금을 실시간으로 확인하여 주문 자동 처리
• 예금주 조회 API: 계좌번호로 예금주 이름 확인
• 잔액 조회: 현재 계좌 잔액 실시간 확인
• 5개 은행 지원: 농협, 국민, 우리, 기업, 신한 (빠른계좌 등록 필요)

특히 스타트업과 소상공인이 가장 많이 찾는 기능은 자동 입금확인 API입니다. 쇼핑몰, 예약 시스템에서 고객의 무통장입금을 실시간으로 확인하고 자동으로 주문을 처리할 수 있습니다.

2. 계좌조회api를 선택해야 하는 이유

계좌조회api가 다른 금융 API와 다른 점은 무엇일까요?

즉시 시작 가능

기존 금융 API는 심사 기간이 2-4주 걸리고 서류 준비도 복잡합니다. 하지만 계좌조회api는 이메일 인증만으로 즉시 API Key를 발급받아 바로 사용할 수 있습니다.

완전 무료

계좌조회api는 완전 무료이며, 앞으로도 유료화 계획이 없습니다. 소규모 쇼핑몰이나 스타트업이 부담 없이 사용할 수 있습니다. 기존 금융 API는 최소 월 수십만 원의 비용이 발생하지만, 계좌조회api는 진입장벽이 없습니다.

간편한 연동

계좌조회api는 표준 REST API로 설계되어 어떤 프로그래밍 언어에서도 쉽게 연동할 수 있습니다. Node.js, Python, Java, PHP 등 모든 환경에서 동일하게 동작합니다.

무료 오픈 서비스

계좌조회api는 스타트업·소상공인·개발자를 위한 무료 오픈 서비스입니다. 한국 금융 API 생태계가 제한적인 상황에서, 개발자들이 자유롭게 금융 기술을 배우고 활용할 수 있도록 돕고 있습니다.

3. 계좌조회api 회원가입 (2분)

계좌조회api 회원가입은 매우 간단합니다. 2분이면 완료됩니다.

Step 1: 회원가입 페이지 접속

bankapi.co.kr/signup에 접속합니다.

Step 2: 이메일 입력

사용하실 이메일 주소를 입력하고 "인증 코드 받기" 버튼을 클릭합니다. 입력한 이메일로 6자리 인증 코드가 전송됩니다.

Step 3: 인증 코드 입력

이메일로 받은 6자리 인증 코드를 입력합니다. 코드는 5분간 유효하며, 5회까지 시도할 수 있습니다.

Step 4: API Key 발급

인증이 완료되면 즉시 API Key와 Secret Key가 발급됩니다. 이 키는 계좌조회api를 호출할 때 인증에 사용됩니다.

발급받은 키는 즉시 이메일로도 전송되므로 나중에 확인할 수 있습니다.

4. 첫 번째 API 호출하기

이제 계좌조회api를 실제로 호출해보겠습니다.

API 엔드포인트

POST https://api.bankapi.co.kr/v1/transactions

인증 헤더

계좌조회api는 Bearer Token 방식으로 인증합니다. API Key와 Secret Key를 콜론(:)으로 연결하여 Authorization 헤더에 포함시킵니다.

Authorization: Bearer {apiKey}:{secretKey}

Node.js 예제

const response = await fetch('https://api.bankapi.co.kr/v1/transactions', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}:${secretKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    bankCode: 'NH',
    accountNumber: '123456789012',
    accountPassword: '1234',      // 계좌 비밀번호(4자리)
    residentNumber: '900101',     // 주민번호 앞 6자리
    startDate: '20260101',        // 조회 시작일 (YYYYMMDD)
    endDate: '20260116'           // 조회 종료일 (YYYYMMDD)
  })
});

const data = await response.json();
console.log(data);

Python 예제

import requests

response = requests.post(
    'https://api.bankapi.co.kr/v1/transactions',
    headers={
        'Authorization': f'Bearer {api_key}:{secret_key}',
        'Content-Type': 'application/json'
    },
    json={
        'bankCode': 'NH',
        'accountNumber': '123456789012',
        'accountPassword': '1234',      # 계좌 비밀번호(4자리)
        'residentNumber': '900101',     # 주민번호 앞 6자리
        'startDate': '20260101',        # 조회 시작일 (YYYYMMDD)
        'endDate': '20260116'           # 조회 종료일 (YYYYMMDD)
    }
)

data = response.json()
print(data)

응답 예제

{
  "success": true,
  "transactions": [
    {
      "date": "2026-01-16",
      "time": "14:32:10",
      "description": "FBS입금",
      "displayName": "",
      "counterparty": "홍길동",
      "amount": 50000,
      "balance": 1500000,
      "type": "deposit"
    }
  ],
  "accountInfo": {
    "accountNumber": "123456789012",
    "balance": 1500000
  }
}

이렇게 간단하게 계좌조회api를 통해 거래내역을 조회할 수 있습니다.

5. 자동 입금확인 API 구현

계좌조회api의 가장 인기 있는 사용 사례는 쇼핑몰의 자동 입금확인 API 구현입니다.

시나리오

고객이 쇼핑몰에서 무통장입금으로 주문했습니다. 주문번호는 ORD-12345이고, 입금 금액은 50,000원입니다. 계좌조회api를 사용하여 입금을 자동으로 확인하고 주문 상태를 변경해보겠습니다.

자동 입금확인 로직

// 1. 계좌조회api로 오늘 거래내역 조회
const today = new Date().toISOString().slice(0, 10).replace(/-/g, ''); // "20260117"

const response = await fetch('https://api.bankapi.co.kr/v1/transactions', {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${apiKey}:${secretKey}`,
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    bankCode: 'NH',
    accountNumber: '123456789012',
    accountPassword: '1234',      // 계좌 비밀번호(4자리)
    residentNumber: '900101',     // 주민번호 앞 6자리
    startDate: today,
    endDate: today
  })
});

const data = await response.json();  // 응답: { success, transactions, accountInfo }

// 2. 주문 금액과 일치하는 입금 찾기 (type은 'deposit')
const orderAmount = 50000;
const deposit = data.transactions.find(tx =>
  tx.type === 'deposit' && tx.amount === orderAmount
);

if (deposit) {
  // 3. 입금 확인 완료 - 주문 상태 업데이트
  await updateOrderStatus('ORD-12345', 'paid');
  console.log('입금 확인 완료!');
}

실시간 모니터링

더 나아가 cron job이나 스케줄러를 사용하여 5분마다 계좌조회api를 호출하면 실시간으로 입금을 확인할 수 있습니다. 같은 계좌는 5분에 1회만 조회되므로, 폴링 주기는 5분 이상으로 설정하세요.

// 5분마다 실행
setInterval(async () => {
  await checkNewDeposits();
}, 5 * 60 * 1000);

계좌조회api는 완전 무료이며 월간 건수 상한이 없습니다. 다만 같은 계좌는 5분에 1회만 조회되고, 30분당 최대 30회(성공)·60회(요청)로 제한되므로, 5분마다 1회 호출하는 폴링이 가장 안정적입니다.

6. 계좌조회api 활용 팁

1. API Key 안전하게 보관하기

계좌조회api의 Secret Key는 절대 GitHub 등 공개 저장소에 커밋하지 마세요. 환경 변수(.env 파일)로 관리하세요.

# .env
BANK_API_KEY=pk_live_xxxxx
BANK_API_SECRET=sk_live_xxxxx

2. 에러 처리

계좌조회api 호출 시 네트워크 오류나 은행 서버 오류가 발생할 수 있습니다. try-catch로 에러를 처리하세요.

try {
  const data = await callBankAPI();
} catch (error) {
  console.error('계좌조회api 호출 실패:', error);
  // 재시도 로직 또는 알림
}

3. Rate Limit 준수

계좌조회api는 완전 무료이며 월간 건수 상한은 없습니다. 다만 같은 계좌는 5분에 1회만 조회되고, 30분당 최대 30회(성공)·60회(요청)로 제한됩니다. 폴링 주기는 5분 이상으로 설정하여 한도를 초과하지 않도록 주의하세요.

4. 테스트 모드 활용

API 테스트 페이지에서 회원가입 없이 계좌조회api를 체험해볼 수 있습니다. 실제 구현 전에 응답 형식을 확인하세요.

5. 문서 참고

공식 API 문서에서 모든 엔드포인트, 파라미터, 응답 형식을 확인할 수 있습니다. 계좌조회api 연동 시 필수로 확인하세요.

마치며

계좌조회api는 한국 은행의 거래내역을 쉽고 빠르게 조회할 수 있는 강력한 도구입니다. 기존 금융 API의 높은 진입장벽과 비용 문제를 해결하여, 누구나 부담 없이 금융 데이터를 활용할 수 있도록 돕고 있습니다.

자동 입금확인 API, 계좌 거래내역 조회 API, 예금주 조회 API 등 다양한 기능을 제공하는 계좌조회api를 지금 바로 시작해보세요.