82bank 시작 가이드: 가입부터 첫 거래 확인까지
82bank 는 회사 계좌의 입출금 내역을 정해 둔 주기마다 가져와 저장해 두는 서비스입니다. 저장한 내역은 관리 화면에서 보고, API 로 가져가고, 새 거래가 생기면 웹훅으로 받습니다. 이 글은 처음 가입한 분이 첫 거래를 눈으로 확인하기까지 해야 할 일을 순서대로 적었습니다. 지금 누구나 등록할 수 있는 은행은 신한은행(간편조회서비스, 이용자 ID 로그인)이라 신한은행 계좌를 예로 듭니다. 농협·하나은행(빠른조회)도 열려 있고, 국민·우리·기업은행은 시험 중이며, 열려도 순서는 같습니다.
1. 소셜 계정으로 로그인
오른쪽 위 [로그인]을 누르고 구글, 네이버, GitHub 중 하나를 고르거나, 이메일 주소를 넣고 메일로 받은 6자리 인증 코드를 넣습니다. 처음 로그인하면 그 자리에서 가입 단위(회사)가 하나 만들어지고, 로그인한 사람이 소유자가 됩니다. 아이디나 비밀번호를 따로 만들지 않습니다. 같은 이메일이라도 구글로 들어온 계정, GitHub 로 들어온 계정, 이메일 코드로 들어온 계정은 서로 다른 계정이니, 회사에서 함께 쓸 계정을 하나 정해 두세요. 가입하면 14일 동안 무료로 씁니다.
2. 계좌 등록
관리 화면 [계좌관리]에서 [계좌 등록]을 누르고 은행을 고릅니다. 은행을 고르면 그 은행에 필요한 항목과, 은행 사이트에서 미리 신청해 둬야 하는 조회 서비스 이름(빠른조회·간편조회서비스)이 안내됩니다. 신한은행은 다음처럼 넣습니다.
- 미리 할 일: 신한은행 인터넷뱅킹에서 간편조회서비스에 가입하고, 조회할 계좌를 간편계좌로 등록합니다.
- 이용자 ID·로그인 비밀번호: 간편조회서비스에서 만든 것.
- 계좌번호·계좌 비밀번호: 조회할 계좌의 것(생년월일·사업자번호는 받지 않습니다).
- 수집 주기: 10분, 30분, 1시간, 하루 중 하나(기본 1시간). 10분·30분은 이용료를 결제한 뒤 고를 수 있습니다.
은행 로그인 비밀번호를 틀리면 은행 계정이 잠길 수 있습니다. 82bank 는 같은 ID 로 두 번 실패하면 더 시도하지 않습니다.
등록 버튼을 누르면 82bank 가 바로 최근 3일 치를 한 번 조회해 봅니다. 인증정보가 틀려 은행이 거절하면 그 자리에서 오류를 보여 주고 아무것도 저장하지 않습니다. 성공하면 계좌가 저장되고 최근 30일 치 수집이 대기열에 들어갑니다. 입력한 비밀번호는 저장 전에 암호화되고, 다시 화면에 보이지 않습니다. 실제 은행 계좌가 잠기지 않도록, 등록 확인이 한 번 거절된 계좌번호·이용자 ID 로는 다시 등록 확인을 보내지 않습니다(VERIFY_LIMIT). 거절되면 은행 사이트에서 정보(빠른조회 등록 포함)를 먼저 확인한 뒤 오류 아래의 [초기화 요청]을 누르세요. 5분 뒤 다시 시도할 수 있습니다(같은 계좌는 30일에 2번까지, 그 뒤에는 help@2nd-korea.com 으로 문의). 실제 은행 확인은 가입 단위마다 하루 10번까지입니다.
3. 계좌통합에서 내역 보기
[계좌통합] 메뉴를 열면 등록한 모든 계좌의 입출금이 한 표에 시간순으로 보입니다. 기간, 계좌, 입금·출금, 금액, 검색어로 걸러 보고 [엑셀 받기]로 내려받을 수 있습니다. 줄을 누르면 오른쪽에 자세한 내용과 메모 칸이 열립니다. 다음 주기를 기다리지 않고 새 거래를 보려면 [계좌관리]에서 그 계좌의 [지금 수집]을 누릅니다(같은 계좌 5분에 한 번).
4. API 키를 만들고 호출해 보기
[API 키]에서 키를 만들면 API 키(bk_로 시작)와 시크릿(sk_로 시작)이 나옵니다. 시크릿은 이때 한 번만 보이니 바로 안전한 곳에 저장하세요. 잃어버리면 키를 폐기하고 새로 만듭니다. 키가 맞는지는 GET /v1/ping 으로 확인하고, 계좌 목록과 저장 내역은 다음처럼 받습니다. 셋 다 은행에 가지 않습니다.
# 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"
더 자세한 시험 순서는 API 테스트 페이지에 있습니다. 은행에 바로 가서 조회하는 실시간 조회는 API 문서를 보세요.
5. 웹훅 걸기
주기적으로 API 를 부르는 대신, 새 입금이 저장될 때 알려 받고 싶다면 [데이터전송]에서 웹훅 주소를 등록합니다. https:// 주소만 받고, 등록하면 서명용 시크릿이 만들어집니다. 웹훅은 계좌를 등록한 날 이후의 새 거래만 보냅니다. 등록할 때 가져온 지난 30일 치는 웹훅으로 오지 않으니, 그 기간은 API 의 저장 내역으로 받으세요. [시험 전송]으로 받는 서버가 제대로 답하는지 먼저 확인하세요. 서명을 검증하는 방법은 웹훅 받고 서명 검증하기에 정리했습니다.
다음에 할 일
무통장입금 주문을 받는 쇼핑몰이라면 무통장입금 자동확인 만들기를, 직원에게 일부 계좌만 보여 주려면 [부이용자] 메뉴를 보세요. 막히는 곳이 있으면 help@2nd-korea.com 으로 어느 화면에서 무엇을 눌렀는지 알려 주시면 확인해 드립니다.