시작하기
10분이면 첫 거래를 봅니다
가입, 계좌 등록, 내역 확인, API 호출까지 순서대로 따라 하면 됩니다. 지금 누구나 등록할 수 있는 은행은 신한은행(간편조회서비스, 이용자 ID 로그인)과 농협은행(빠른조회)입니다.
1. 로그인
- 오른쪽 위 [로그인]을 누르고 구글, 네이버, GitHub 중 하나로 로그인하거나, 이메일로 받은 인증 코드로 로그인합니다.
- 처음이면 가입 단위(회사)가 만들어지고, 로그인한 사람이 소유자가 됩니다. 14일 무료 체험이 시작됩니다.
같은 이메일이라도 로그인한 서비스가 다르면 다른 계정입니다. 회사에서 쓸 로그인 방법을 하나로 정해 두세요.
2. 계좌 등록
- 관리 화면 [계좌관리] → [계좌 등록]에서 은행을 고릅니다. 은행마다 필요한 항목과, 은행 사이트에서 미리 신청할 조회 서비스 이름이 안내됩니다.
- 신한은행은 먼저 신한은행 인터넷뱅킹에서 간편조회서비스에 가입하고 계좌를 간편계좌로 등록해 둡니다. 82bank 에는 거기서 만든 이용자 ID·비밀번호와 계좌번호·계좌 비밀번호를 넣습니다.
- 수집 주기(10분 · 30분 · 1시간 · 하루, 기본 1시간 — 10분·30분은 이용료 결제 뒤)를 고르고 등록합니다. 그 자리에서 최근 3일을 한 번 조회해 맞을 때만 저장하고, 최근 30일 치를 가져옵니다.
실제 은행 계좌가 비밀번호 오류로 잠기지 않도록, 은행이 인증정보를 거절하면 그 계좌의 수집을 멈추고(CREDENTIAL_BLOCKED — 새 인증정보를 저장해야 다시 수집), 같은 은행·계좌번호(신한은 같은 이용자 ID 도)로 인증정보 오류가 연달아 2번 나면 누가 시도하든 은행에 더 보내지 않습니다(VERIFY_LIMIT). 새 계좌 등록 확인은 오류가 한 번이라도 있던 계좌번호·이용자 ID 로는 보내지 않고(은행에서 확인한 뒤 [초기화 요청]을 누르면 5분 뒤 다시 시도, 같은 계좌는 30일에 2번까지), 가입 단위마다 하루 10번까지입니다. 은행 사이트에서 비밀번호를 확인한 뒤 시도하세요. 사업자등록번호와 생년월일은 은행에 보내기 전에 자릿수와 검증 숫자를 먼저 확인합니다.
3. 내역 확인
- [계좌통합]에서 모든 계좌의 거래를 시간순으로 봅니다. 기간·계좌·입출금·금액·검색으로 거르고 [엑셀 받기]로 내려받습니다.
- 새 거래를 바로 보고 싶으면 그 계좌의 [지금 수집]을 누릅니다(같은 계좌 5분에 한 번).
4. API 호출
- [API 키]에서 키를 만듭니다. 시크릿(
sk_…)은 이때 한 번만 보이니 바로 저장합니다. - 연결 확인(
/v1/ping), 계좌 목록, 저장 내역 순서로 불러 봅니다. 셋 다 은행에 가지 않습니다(API 테스트). - 자기 서버에서는
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. 웹훅 · 자동입금확인
- [데이터전송]에서 웹훅 주소(
https://)와 받을 이벤트를 고르고 [시험 전송]으로 확인합니다. 웹훅은 계좌 등록 뒤에 새로 생긴 거래만 보냅니다(등록 때 가져온 지난 30일 치는 보내지 않습니다). 서명 검증은 API 문서에 있습니다. - 무통장입금 주문을 받는다면 [상점관리]에서 상점을 만들고 자동입금확인 가이드를 따라 주문을 등록합니다.
- 직원과 함께 쓴다면 [부이용자]에서 초대 주소(7일 동안 한 번 쓸 수 있음)를 만들어 보내고, 받은 사람이 소셜 로그인으로 들어오면 계좌별로 입금·출금·잔액을 볼 수 있는지 정합니다.