급여 정산 업무에 계좌 거래내역 조회 API를 활용하는 방법
급여 지급 후 은행 계좌의 출금 내역을 API로 조회해 정산 대장과 대조하는 방법과, 조회 전용 서비스의 범위를 정리했습니다.
급여 정산에 계좌 거래내역 조회를 어떻게 쓰나요?
급여일이 지나면 지급이 제대로 나갔는지 확인해야 합니다. 방법은 단순합니다. 급여를 지급한 뒤 은행 계좌의 출금 내역을 API로 가져와 급여 대장과 대조하는 데 쓸 수 있습니다. 직접 은행 화면을 열어 확인하던 절차를 조회 요청 한 번으로 바꿀 수 있습니다.
뱅크레일은 공동인증서로 은행 인터넷뱅킹에 접속해 은행 계좌 잔액과 거래내역을 조회합니다. 조회 전용이므로 입금과 이체를 실행하는 기능은 없고, 카드 사용내역 조회 기능도 없습니다.
어떤 순서로 대조하나요?
회사 계좌의 공동인증서를 등록합니다. 조회 대상당 1개를 등록하며, 다시 등록하면 교체됩니다.
지급일 이후 기간을 지정해 실시간 거래내역 조회를 요청합니다. 요청한 시점에 은행에서 직접 조회하며 저장하지 않습니다.
응답으로 입금·출금 합계와 상대방별 요약을 함께 받습니다.
받은 내역을 회사의 급여 대장과 자체 시스템에서 대조합니다. 대조 기준과 불일치 처리는 회사 시스템에서 구현합니다.
실시간 거래내역 조회는 은행 로그인이 일어나 수 초에서 수십 초가 걸릴 수 있고 조회 1건으로 계산됩니다. 요청 방법은 실시간 거래내역 조회 API 안내에서 확인하세요.
뱅크레일이 하지 않는 일은 무엇인가요?
| 업무 | 제공 여부 |
|---|---|
| 은행 계좌 잔액·거래내역 조회 | 제공합니다 |
| 급여 이체 실행, 송금 실행 | 제공하지 않습니다. 조회 전용입니다 |
| 카드 사용내역 조회 | 제공하지 않습니다 |
| 거래가 생길 때마다 알려 주는 기능 | 제공하지 않습니다. 웹훅은 조회 작업의 완료를 알려 줍니다 |
대조 결과는 어떤 표로 정리하나요?
조회한 출금 내역과 급여 대장을 아래처럼 맞춰 보면 차이가 나는 줄만 골라낼 수 있습니다. 날짜와 금액은 모두 예시입니다.
| 지급 예정일 | 급여 대장 금액 | 조회된 출금 금액 | 판정 |
|---|---|---|---|
| 2026-11-10 | 2,500,000 | 2,500,000 | 일치 |
| 2026-11-10 | 3,100,000 | 3,010,000 | 금액 불일치, 확인 필요 |
| 2026-11-10 | 2,800,000 | (내역 없음) | 미지급 또는 조회 기간 누락, 확인 필요 |
조회 기간을 지급일 전후까지 넉넉히 잡고, 실시간 거래내역 조회로 필요한 기간만 확인하거나 저장된 결과를 가져오면 됩니다. 판정이 불일치인 건은 사람이 확인하는 흐름으로 두세요.
조회가 비어 있거나 실패하면 어떻게 하나요?
대조표에서 내역이 없는 줄이 나오면 지급이 안 된 것인지, 조회가 실패했거나 기간이 어긋난 것인지 먼저 가려야 합니다. 조회 작업의 status가 failed이면 error 필드의 사유를 보고 다시 조회하고, blocked나 cert_not_registered이면 회사 계좌의 인증서 상태를 확인한 뒤 재등록하세요. 이 확인이 끝나기 전에는 미지급으로 단정하지 않는 것이 안전합니다.
자주 묻는 질문
급여 이체까지 자동으로 할 수 있나요?
할 수 없습니다. 뱅크레일은 조회 전용이어서 이체 실행 기능이 없습니다. 이체는 회사가 사용하는 은행 서비스에서 진행하고, 결과 확인에 조회를 쓰는 용도입니다.
여러 계좌를 한꺼번에 확인할 수 있나요?
조회 요청을 일괄로 보낼 수 있고, 한 번에 최대 500건입니다. 완료 시 웹훅으로 결과를 받거나 저장된 결과를 API로 가져옵니다.