오픈뱅킹 사용기관 등록 (운영자)

## 먼저 판단할 것 법인 계좌 데이터를 얻는 경로는 두 가지입니다. | | 오픈뱅킹 | 금융 데이터 연동 서비스(CODEF) | |---|---|---| | 운영자 등록 | 금융결제원 **사용기관 등록** (심사 1~2개월) | 서비스 계약 | | 고객 준비물 | 계좌 소유자 승인만 | 공동인증서 파일 + 비밀번호 | | 갱신 | 자동 | 인증서 만료 시 재등록 | | 보안 관점 | 인증서를 맡기지 않아 유리 | 인증서·비밀번호 보관 필요 | | 도입 속도 | 느림 | 빠름 | **빠르게 시작해야 하면 CODEF, 장기적으로 안전하고 편한 것은 오픈뱅킹**입니다. 현재 서비스는 CODEF 기반 [법인 은행 계좌 연동](/news/guide/codef-bank)이 운영 경로이고, 오픈뱅킹은 테스트베드 연결 단계입니다. ## 사전 준비물 - [ ] **사업자** 자격 — 개인은 사용기관 등록이 불가합니다 - [ ] **사업계획서** — 어떤 서비스에 왜 계좌 정보가 필요한지 - [ ] 1금융권 인증서 또는 사업자 인증서 - [ ] 서비스 도메인 (HTTPS) - [ ] 개인정보 처리방침 (금융 정보 처리 항목 포함) ## 등록 절차 ### 1. 사용기관 등록 신청 1. [오픈뱅킹 포털](https://openbanking.or.kr) → **이용 신청** → 사용기관 등록 2. 서비스 신청서 작성 3. **사업계획서 첨부** 4. 심사 대기 ### 2. 심사 **1~2개월**. 금융권 심사이므로 가장 오래 걸립니다. 심사에서 주로 확인하는 것: - 계좌 정보를 **왜** 필요로 하는지 (서비스 필요성) - 수집한 정보를 **어떻게 보관·파기**하는지 - 개인정보 처리방침에 금융 정보 처리가 명시돼 있는지 - 보안 대책 > **첫날에 신청하세요.** 다른 플랫폼을 다 붙이는 동안 이 심사가 돕니다. ### 3. 개발자 포털에서 앱 등록 심사 통과 후 [금융결제원 개발자 포털](https://developers.kftc.or.kr) 에서: 1. **마이페이지 → 테스트 정보 관리 → 오픈뱅킹** → 앱 등록 2. 사용할 API 선택 | API | 무엇을 위해 | |---|---| | 잔액 조회 | 계좌 잔액 | | 거래내역 조회 | 입출금 내역 | | 계좌 실명 조회 | 계좌 검증 | 3. **Client ID** / **Client Secret** 발급 ### 4. Callback URL 등록 **API Key 관리 → Callback URL** 에 등록합니다. ``` https://<서비스 도메인>/auth/openbanking/callback ``` ## 모닝인사이트에 입력 `/admin` 운영자 콘솔 → OpenBanking 섹션에 Client ID / Secret 을 입력합니다. ## 테스트베드 → 운영 전환 오픈뱅킹은 **테스트베드**와 **운영** 환경이 분리돼 있습니다. | 환경 | 용도 | |---|---| | 테스트베드 | 가상 계좌로 흐름 검증 | | 운영 | 실계좌 조회 | 테스트베드에서 흐름을 검증한 뒤 운영 전환을 신청합니다. 전환 시 서비스 쪽 API 주소 설정도 함께 바뀌어야 합니다. > ⚠️ 현재 서비스는 **테스트베드에 연결된 상태**입니다. > 실계좌 조회로 전환하려면 사용기관 등록 완료 + 운영 환경 설정 변경이 함께 필요합니다. ## 자주 나는 오류 | 오류 | 원인 | 해결 | |---|---|---| | 심사 반려 | 사업계획서에 필요성·보안 설명 부족 | 데이터 사용 목적과 보관·파기 정책을 구체적으로 보완 | | `redirect_uri_mismatch` | Callback URL 불일치 | 포털 등록 값 확인 | | 실계좌가 조회되지 않는다 | 테스트베드 환경 | 운영 전환 필요 | | 잔액만 되고 거래내역 실패 | 거래내역 조회 API 미신청 | 포털에서 API 추가 | ## 관련 문서 - [Outlook 앱 등록](/news/guide/operator-outlook) - 고객용: [오픈뱅킹 계좌 연동](/news/guide/openbanking) · [법인 은행 계좌 연동](/news/guide/codef-bank)