Cafe24 앱 등록 (운영자)

## 이 등록으로 얻는 것 고객 Cafe24 쇼핑몰의 주문 · 상품 · 매출 · 방문자 통계 조회. ## 사전 준비물 - [ ] [Cafe24 개발자센터](https://developers.cafe24.com) 계정 - [ ] 회사 **사업자등록증** - [ ] 서비스 도메인 - [ ] 테스트용 Cafe24 쇼핑몰 (본인 mall) — 검수 전 테스트에 필요 ## 등록 절차 ### 1. 앱 만들기 1. [Cafe24 Developers](https://developers.cafe24.com) → **앱 만들기** 2. 앱 정보 입력 | 항목 | 값 | |---|---| | 앱 이름 | `Morning Insight` | | 카테고리 | 분석/리포트 | | 설명 | 매출 분석 대시보드 | ### 2. 앱 권한(Scope) 설정 아래 권한을 추가합니다. | 권한 | 필수 | 무엇을 위해 | |---|---|---| | `mall.read_application` | ✅ | 앱 설치 확인 | | `mall.read_order` | ✅ | **주문 — 매출 분석의 핵심** | | `mall.read_product` | ✅ | 상품 | | `mall.read_analytics` | 선택 | 방문자 통계 | | `mall.read_customer` | 선택 | 고객 분석 | > ⚠️ 권한이 빠지면 고객 쪽에서 "연동됨인데 주문이 안 보인다"가 발생합니다. > 나중에 권한을 추가하면 **고객이 다시 계정 연결**을 해야 합니다. > 필요한 권한은 처음에 다 넣어 두세요. ### 3. Redirect URI 등록 ``` https://<서비스 도메인>/auth/cafe24/callback ``` ### 4. Client ID · Secret 발급 앱을 만들면 **Client ID** 와 **Client Secret** 이 발급됩니다. ## 모닝인사이트에 입력 `/admin` 운영자 콘솔 → Cafe24 섹션 | 항목 | |---| | Client ID | | Client Secret | ## 심사 | 단계 | 조건 | |---|---| | **개발 단계** | **본인 mall(테스트 mall_id)만** OAuth 가능 | | **운영 (앱스토어 등록)** | 검수 후 다른 고객 mall 도 설치 가능 | 검수 기간은 **1~2주**입니다. > ⚠️ **개발 단계에서는 고객 쇼핑몰을 연동할 수 없습니다.** > 고객이 `계정 연결` 을 눌러도 실패합니다. 실제 고객을 받기 전에 검수를 마쳐야 합니다. ## 자주 나는 오류 | 오류 | 원인 | 해결 | |---|---|---| | 고객 mall 연결 실패 | 앱이 개발 단계 | 앱스토어 검수 완료 필요 | | `redirect_uri_mismatch` | Redirect URI 불일치 | 개발자센터 등록 값 확인 | | 주문이 조회되지 않는다 | `mall.read_order` 누락 | 권한 추가 → 고객 재연결 안내 | | 방문자 통계만 없다 | `mall.read_analytics` 누락 | 위와 동일 | | Mall ID 오류 | 고객이 도메인 전체를 입력 | 앞부분만 (`mymall.cafe24.com` → `mymall`) | ## 관련 문서 - [스마트스토어 앱 등록](/news/guide/operator-smartstore) - 고객용: [Cafe24 연동](/news/guide/cafe24)