법인 은행 계좌 연동

## 이 연동으로 보이는 것 - 법인 계좌 **잔액** - **입출금 거래내역** (일자 · 적요 · 금액 · 잔액) - 은행 계좌 화면 상세, 재무 화면 반영 - 여러 계좌를 등록하고 라벨로 구분 현재 **운영에서 실계좌 조회가 가능한 경로**입니다. ## ⚠️ 시작 전 확인 이 연동은 **법인 공동인증서 파일과 비밀번호를 서비스에 등록**해야 합니다. 반드시 **재무 담당자와 내부 승인 절차를 거쳐** 진행하세요. 권장 사항: - 이체 권한이 없는 **조회 전용 인증서**를 쓸 수 있으면 그것을 사용 - 개인 명의가 아닌 **법인 명의 인증서** - 인증서 만료일(보통 발급 후 1년)을 **캘린더에 등록** 자격증명이 어떻게 보관되는지는 [자격증명 보관과 보안](/news/guide/integration-security)에 있습니다. ## 지원 은행 | 은행 | |---| | KB국민 · IBK기업 · NH농협 · 우리 · 하나 · 신한 · SC제일 | | 카카오뱅크 · 케이뱅크 · 토스뱅크 | 목록에 없는 은행은 [문의](/news/guide/contact)해 주세요. ## 사전 준비물 연동은 **두 단계**입니다. 준비물도 두 벌입니다. ### 1단계 — 연동 서비스 기본 정보 (워크스페이스당 한 번) | 항목 | 비고 | |---|---| | **Client ID** | UUID 형식 | | **Client Secret** | | | **RSA Public Key** | base64 문자열 (PEM 헤더 제외) | > 이 값들은 금융 데이터 연동 서비스(CODEF) 계약 시 발급됩니다. > 이미 등록돼 있으면 2단계로 바로 넘어가면 됩니다. 없으면 [문의](/news/guide/contact)해 주세요. ### 2단계 — 계좌별 등록 (계좌마다) | 항목 | 비고 | |---|---| | **기관(은행) 선택** | 위 지원 목록 중 | | **라벨** | 선택 — 예: `KB국민 운영계좌` | | **공동인증서 파일** | `.cer` 또는 `.der` | | **인증서 개인키 파일** | `.key` | | **인증서 비밀번호** | | > 인증서 파일과 개인키는 **한 쌍**이어야 합니다. > 은행에서 인증서를 내보내면 보통 두 파일이 함께 나옵니다. ## 연동 절차 ### 1단계 — 기본 정보 등록 1. **설정 → 데이터 연동** 탭 2. **Codef 연동** 영역에서 기본 정보 입력 창을 엽니다 3. Client ID · Client Secret · RSA Public Key 입력 4. **저장** ### 2단계 — 계좌 등록 1. **Codef 연동 → 법인 은행 계좌** 클릭 2. **기관(은행)** 선택 3. **라벨** 입력 (여러 계좌를 쓸 때 화면에서 구분됩니다) 4. **공동인증서 파일(.cer/.der)** 과 **개인키(.key)** 업로드 5. **인증서 비밀번호** 입력 6. **등록** 여러 계좌를 등록하려면 2단계를 반복합니다. ## 확인 방법 1. 등록된 계좌 목록에 은행명 · 라벨 · 등록일이 표시되는지 2. **은행 계좌** 화면에 잔액이 나오는지 3. 거래내역이 실제 통장과 맞는지 4. **재무** 화면에 반영됐는지 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 인증서 오류 | 인증서와 개인키가 **한 쌍이 아님** | 은행에서 다시 내보내 두 파일을 함께 사용 | | 인증서 오류 | 인증서 비밀번호 불일치 | 비밀번호 재확인 | | 인증서 오류 | 파일 형식이 `.cer/.der/.key` 가 아님 | 형식 확인 후 재업로드 | | 등록은 됐는데 갑자기 중단 | **공동인증서 만료** (보통 1년) | 은행에서 갱신 후 **재등록** | | 등록 실패 | 1단계 기본 정보 미등록 | 기본 정보를 먼저 저장 | | 잔액은 되는데 거래내역이 없다 | 조회 기간에 거래가 없음 | 기간을 넓혀 확인 | | 특정 은행만 실패 | 은행별 인증 요건 차이 | [문의](/news/guide/contact) | ## 정기 점검 | 주기 | 확인 | |---|---| | 매주 | 잔액이 어제 날짜로 갱신되는지 | | 연 1회 | **공동인증서 만료일** 확인 및 갱신 | | 담당자 교체 시 | 인증서 파일·비밀번호 인수인계 | > 인증서 만료로 연동이 끊기면 화면에는 **지난번 잔액이 그대로 남아** 눈치채기 어렵습니다. > 만료일 관리가 이 연동의 핵심 운영 업무입니다. ## 제약 - 공동인증서 만료 시 재등록이 필요합니다 (자동 갱신 불가) - 조회 가능한 거래내역 기간은 은행 정책을 따릅니다 - 계좌마다 개별 등록해야 합니다 ## 관련 문서 - [법인 신용카드 연동](/news/guide/codef-cards) - [오픈뱅킹 계좌 연동](/news/guide/openbanking) - [자격증명 보관과 보안](/news/guide/integration-security)