Cafe24 연동

## 이 연동으로 보이는 것 - 주문 건수 · 주문 금액 · 취소/환불 - 상품별 판매 현황 - 방문자 통계 - 모닝 대시보드 매출 지표, 쇼핑몰 화면 상세 ## 사전 준비물 | 항목 | 어디서 | 비고 | |---|---|---| | Cafe24 쇼핑몰 **관리자 계정** | — | | | **Mall ID** | 쇼핑몰 도메인 앞부분 | `mymall.cafe24.com` → `mymall` | | **Client ID** | Cafe24 Developers 앱 | | | **Client Secret** | 같은 앱 | | ## 발급 절차 ### 1. 앱 만들기 1. [Cafe24 Developers](https://developers.cafe24.com) 에 로그인 2. **앱 만들기** → 앱 이름·설명 입력 3. **권한(Scope)** 설정 — 아래를 반드시 포함하세요 | 권한 | 무엇을 위해 | |---|---| | `mall.read_order` | 주문 조회 | | `mall.read_product` | 상품 조회 | | `mall.read_analytics` | 방문자·통계 조회 | > ⚠️ **권한이 빠지면 연결은 되는데 그 데이터만 계속 비어 있습니다.** > "연동됨인데 주문이 안 보인다"의 대부분이 `mall.read_order` 누락입니다. 4. 저장 후 **Client ID** 와 **Client Secret** 확인 ### 2. Mall ID 확인 쇼핑몰 주소가 `mymall.cafe24.com` 이면 Mall ID 는 **`mymall`** 입니다. 자체 도메인을 쓰더라도 Cafe24 관리자 로그인 시 쓰는 ID 기준입니다. ## 모닝인사이트에 입력 1. **설정 → 데이터 연동** 탭 2. **쇼핑몰 → Cafe24** 카드 클릭 3. Mall ID · Client ID · Client Secret 입력 후 **저장** 4. **계정 연결** 버튼 클릭 → Cafe24 로그인 팝업 5. 권한 요청 화면에서 **모두 허용** 6. 팝업이 닫히고 상태가 `연동됨` 으로 변경 > 저장만 하고 **계정 연결**을 누르지 않으면 데이터가 들어오지 않습니다. 두 단계 모두 필요합니다. ## 확인 방법 1. 카드 상태 `연동됨` 2. **쇼핑몰** 화면에 주문·상품이 나오는지 3. Cafe24 관리자 주문 목록과 같은 기간 건수를 비교 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 연결 후 주문이 안 보인다 | `mall.read_order` 권한 누락 | 앱 권한 추가 → **계정 연결** 재시도 | | 방문자 통계만 없다 | `mall.read_analytics` 누락 | 위와 동일 | | 팝업이 안 열린다 | 브라우저 팝업 차단 | 주소창 팝업 아이콘에서 허용 | | 로그인했는데 실패 | 관리자 권한이 없는 부운영자 계정 | 관리자 계정으로 재시도 | | `redirect_uri_mismatch` | 서비스 앱 설정 문제 | 고객이 해결 불가 → [문의](/news/guide/contact) | | 주문 금액이 관리자와 다르다 | 취소·환불·부가세 처리 기준 차이 | 기준을 맞춰 비교 | ## 제약 - 쇼핑몰이 여러 개면 **쇼핑몰별로 연동**해야 합니다 - 조회 가능한 기간은 Cafe24 API 정책을 따릅니다 - 취소·환불은 사후 반영되어 과거 매출이 정정될 수 있습니다 ## 관련 문서 - [네이버 스마트스토어 연동](/news/guide/smartstore) · [쿠팡 Wing 연동](/news/guide/coupang) · [아임웹 연동](/news/guide/imweb) - [연동 화면 사용법](/news/guide/integration-howto)