오픈뱅킹 계좌 연동

## ⚠️ 현재 상태 오픈뱅킹 연동은 **금융결제원 테스트베드에 연결된 준비 단계**입니다. 실계좌 조회를 지금 바로 운영에 쓰려면 아래를 권합니다. | 목적 | 권장 경로 | |---|---| | 법인 계좌 잔액·입출금을 **지금 운영에서** 보고 싶다 | [법인 은행 계좌 연동](/news/guide/codef-bank) | | 오픈뱅킹 방식 도입을 검토 중이다 | 이 문서 + [문의](/news/guide/contact) | 운영 전환 일정은 [문의](/news/guide/contact)로 확인해 주세요. ## 이 연동으로 보이는 것 - 등록한 계좌의 **잔액** - **입출금 거래내역** - 재무 화면과 은행 계좌 화면에 반영 ## 오픈뱅킹 방식의 장점 법인 계좌 연동(공동인증서 방식)과 비교하면, | | 오픈뱅킹 | 법인 계좌(인증서) | |---|---|---| | 준비물 | 계좌 소유자의 승인만 | 공동인증서 파일 + 비밀번호 | | 갱신 | 토큰 자동 갱신 | 인증서 만료 시 재등록 (보통 1년) | | 보관 위험 | 인증서를 맡기지 않음 | 인증서·비밀번호를 맡겨야 함 | | 지금 운영 가능 | ⚠️ 준비 단계 | ✅ 가능 | 즉 **보안·운영 편의는 오픈뱅킹이 낫고, 지금 쓸 수 있는 것은 법인 계좌 연동**입니다. ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | 금융결제원 개발자 포털 계정 | developers.kftc.or.kr | | | **Client ID / Client Secret** | 포털 → 앱 등록 | | | Callback URL 등록 | 포털 → API Key 관리 | 모닝인사이트 화면에서 복사 | | 조회할 계좌의 **소유자 인증 수단** | — | 승인 단계에서 필요 | ## 발급 절차 ### 1. 개발자 포털에서 앱 등록 1. [금융결제원 개발자 포털](https://developers.kftc.or.kr) 회원가입 2. **마이페이지 → 테스트 정보 관리 → 오픈뱅킹** → 앱 등록 3. 사용할 API 를 선택 — 아래를 포함하세요 - 잔액 조회 - 거래내역 조회 - 계좌 실명 조회 4. **Client ID** 와 **Client Secret** 발급 ### 2. Callback URL 등록 포털의 **API Key 관리 → Callback URL** 항목에 아래 형식을 등록합니다. ``` https://<서비스 도메인>/auth/openbanking/callback ``` > 모닝인사이트의 은행 계좌 연동 화면 상단에 **등록해야 할 Callback URL 이 그대로 표시**됩니다. > 그 값을 복사해 붙여 넣으면 오타를 피할 수 있습니다. ## 모닝인사이트에 입력 1. **설정 → 데이터 연동** 탭 2. **은행 계좌 연동** 카드 클릭 3. Client ID · Client Secret 입력 후 **저장** 4. 화면 상단의 **Callback URL 을 복사**해 금융결제원 포털에 등록 5. **오픈뱅킹 계좌 인증** 버튼 클릭 6. 팝업에서 금융결제원 로그인 → **조회할 계좌 선택** → 동의 7. 팝업이 닫히고 계좌가 등록됩니다 ## 확인 방법 1. **연결 테스트** — 성공하면 **은행명 · 계좌번호 · 잔액**이 표시됩니다 2. **은행 계좌** 화면에 잔액과 거래내역이 나오는지 3. **재무** 화면에 반영됐는지 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | `redirect_uri_mismatch` | 포털의 Callback URL 과 불일치 | 화면에 표시된 값을 **그대로 복사**해 등록 | | 계좌 목록이 비어 있다 | 승인 단계에서 계좌를 선택하지 않음 | 계좌 인증을 다시 진행 | | 잔액만 나오고 거래내역이 없다 | 앱 등록 시 **거래내역 조회 API** 미선택 | 포털에서 API 추가 후 재인증 | | 인증 실패 | Client Secret 복사 시 공백 포함 | 다시 붙여넣기 | | 실계좌가 조회되지 않는다 | 테스트베드 환경 | [문의](/news/guide/contact) | ## 제약 - **현재 테스트베드 연결 단계**로, 실계좌 운영 조회는 준비 중입니다 - 오픈뱅킹은 조회 범위·기간에 금융결제원 정책 제한이 있습니다 - 계좌 소유자의 승인이 필요하며, 승인을 철회하면 조회가 중단됩니다 ## 관련 문서 - [법인 은행 계좌 연동](/news/guide/codef-bank) — 현재 운영 가능한 경로 - [법인 신용카드 연동](/news/guide/codef-cards) - [자격증명 보관과 보안](/news/guide/integration-security)