시작하기

10분이면 첫 거래를 봅니다

가입, 계좌 등록, 내역 확인, API 호출까지 순서대로 따라 하면 됩니다. 지금 누구나 등록할 수 있는 은행은 신한은행(간편조회서비스, 이용자 ID 로그인)과 농협은행(빠른조회)입니다.

1. 로그인

  1. 오른쪽 위 [로그인]을 누르고 구글, 네이버, GitHub 중 하나로 로그인하거나, 이메일로 받은 인증 코드로 로그인합니다.
  2. 처음이면 가입 단위(회사)가 만들어지고, 로그인한 사람이 소유자가 됩니다. 14일 무료 체험이 시작됩니다.

같은 이메일이라도 로그인한 서비스가 다르면 다른 계정입니다. 회사에서 쓸 로그인 방법을 하나로 정해 두세요.

2. 계좌 등록

  1. 관리 화면 [계좌관리] → [계좌 등록]에서 은행을 고릅니다. 은행마다 필요한 항목과, 은행 사이트에서 미리 신청할 조회 서비스 이름이 안내됩니다.
  2. 신한은행은 먼저 신한은행 인터넷뱅킹에서 간편조회서비스에 가입하고 계좌를 간편계좌로 등록해 둡니다. 82bank 에는 거기서 만든 이용자 ID·비밀번호와 계좌번호·계좌 비밀번호를 넣습니다.
  3. 수집 주기(10분 · 30분 · 1시간 · 하루, 기본 1시간 — 10분·30분은 이용료 결제 뒤)를 고르고 등록합니다. 그 자리에서 최근 3일을 한 번 조회해 맞을 때만 저장하고, 최근 30일 치를 가져옵니다.

실제 은행 계좌가 비밀번호 오류로 잠기지 않도록, 은행이 인증정보를 거절하면 그 계좌의 수집을 멈추고(CREDENTIAL_BLOCKED — 새 인증정보를 저장해야 다시 수집), 같은 은행·계좌번호(신한은 같은 이용자 ID 도)로 인증정보 오류가 연달아 2번 나면 누가 시도하든 은행에 더 보내지 않습니다(VERIFY_LIMIT). 새 계좌 등록 확인은 오류가 한 번이라도 있던 계좌번호·이용자 ID 로는 보내지 않고(은행에서 확인한 뒤 [초기화 요청]을 누르면 5분 뒤 다시 시도, 같은 계좌는 30일에 2번까지), 가입 단위마다 하루 10번까지입니다. 은행 사이트에서 비밀번호를 확인한 뒤 시도하세요. 사업자등록번호와 생년월일은 은행에 보내기 전에 자릿수와 검증 숫자를 먼저 확인합니다.

3. 내역 확인

  1. [계좌통합]에서 모든 계좌의 거래를 시간순으로 봅니다. 기간·계좌·입출금·금액·검색으로 거르고 [엑셀 받기]로 내려받습니다.
  2. 새 거래를 바로 보고 싶으면 그 계좌의 [지금 수집]을 누릅니다(같은 계좌 5분에 한 번).

4. API 호출

  1. [API 키]에서 키를 만듭니다. 시크릿(sk_…)은 이때 한 번만 보이니 바로 저장합니다.
  2. 연결 확인(/v1/ping), 계좌 목록, 저장 내역 순서로 불러 봅니다. 셋 다 은행에 가지 않습니다(API 테스트).
  3. 자기 서버에서는 Authorization: Bearer {API 키}:{시크릿} 헤더를 붙여 부릅니다.
# 1) 키 확인
curl -H "Authorization: Bearer bk_여기에_API_키:sk_여기에_시크릿" https://82bank.app/v1/ping

# 2) 등록해 둔 계좌 목록(인증정보는 들어 있지 않습니다)
curl -H "Authorization: Bearer bk_여기에_API_키:sk_여기에_시크릿" https://82bank.app/v1/accounts

# 3) 그 계좌에 저장된 오늘 입금(은행에 가지 않습니다)
curl -H "Authorization: Bearer bk_여기에_API_키:sk_여기에_시크릿" \
  "https://82bank.app/v1/accounts/acc_…/transactions?from=2026-11-18&to=2026-11-18&type=deposit"

5. 웹훅 · 자동입금확인

  1. [데이터전송]에서 웹훅 주소(https://)와 받을 이벤트를 고르고 [시험 전송]으로 확인합니다. 웹훅은 계좌 등록 뒤에 새로 생긴 거래만 보냅니다(등록 때 가져온 지난 30일 치는 보내지 않습니다). 서명 검증은 API 문서에 있습니다.
  2. 무통장입금 주문을 받는다면 [상점관리]에서 상점을 만들고 자동입금확인 가이드를 따라 주문을 등록합니다.
  3. 직원과 함께 쓴다면 [부이용자]에서 초대 주소(7일 동안 한 번 쓸 수 있음)를 만들어 보내고, 받은 사람이 소셜 로그인으로 들어오면 계좌별로 입금·출금·잔액을 볼 수 있는지 정합니다.