내 카페24 몰 연결하기

카페24 개발자센터에서 앱을 하나 만들고, 그 정보를 아래에 붙여 넣으면 끝입니다. 심사·승인은 필요 없습니다 (내 서버에, 내 몰에, 내가 만든 앱을 설치하는 것이라서).

🏬 이미 다른 몰을 이 방법으로 연결해 보셨다면 앱을 새로 만들 필요 없습니다. 개발자센터 → 그 앱 → 테스트 실행 → 새 몰 아이디만 입력해 실행하면, 아래 2단계에 같은 Client ID·Secret과 새 몰 아이디만 넣어서 바로 연결됩니다.

1 카페24 개발자센터에서 앱 만들기

  1. developers.cafe24.com 접속 → 오른쪽 위 로그인 → 몰을 운영하는 카페24 아이디로 로그인
  2. 상단 메뉴에서 내 앱 (또는 앱 관리) → 앱 만들기 버튼
  3. 앱 이름은 아무거나 적습니다 (예: 매출보드). 다음 화면의 입력값은 아래 표 그대로 넣습니다
앱 URLhttps://sales.3-35-56-59.nip.io/app Redirect URIhttps://sales.3-35-56-59.nip.io/oauth/callback 권한(Scope)주문 읽기권한 · 상점 읽기권한
영문으로는 mall.read_order · mall.read_store. 목록이 길면 검색창에 "주문", "상점"으로 찾습니다. "쓰기권한"은 선택하지 않습니다 Webhookhttps://sales.3-35-56-59.nip.io/webhook/cafe24
이벤트: 주문 등록·결제·취소·환불 + 앱 삭제/만료. 이 항목이 화면에 안 보이거나 헷갈리면 건너뛰어도 됩니다 — 1분마다 자동으로 수집되니 필수는 아닙니다

저장하면 Client ID 와 Client Secret 이 나옵니다 (「인증 정보」 또는 「앱 정보」 화면). 이 둘을 아래에 붙여 넣으세요. 화면이 안내와 달라 보여도 입력값 4개(앱 URL·Redirect URI·권한·Webhook)만 맞으면 됩니다.

✅ 저장한 다음, 같은 화면 맨 아래 「테스트 실행」 버튼을 꼭 눌러야 합니다. 팝업에 뜨는 「쇼핑몰 ID」 칸에 위 몰 아이디를 넣고 실행하세요. 값만 저장하고 이 단계를 건너뛰면 아래 2단계에서 연결이 안 됩니다. (「심사요청」은 누르지 마세요 — 앱스토어 정식 공개용이라 지금은 필요 없습니다.)
몰 아이디를 모르겠어요

카페24 관리자로 로그인했을 때 주소창에 뜨는 https://xxx.cafe24.com/disp/admin/... 의 굵게 표시된 부분입니다. 영문 소문자·숫자로만 되어 있습니다.

"redirec_uri invalid" 같은 오류가 떴어요

아래처럼 생긴 오류입니다.

{"error":"invalid_request","error_description":"...redirec_uri...invalid..."}

거의 대부분 「테스트 실행」을 안 눌러서입니다. 값을 저장만 하고 테스트 실행에 몰 아이디를 등록하지 않으면 그 앱은 아직 어떤 몰에서도 쓸 수 없는 상태라 이 오류가 납니다.

  1. 개발자센터 → 그 앱 → 맨 아래 테스트 실행 → 쇼핑몰 ID에 몰 아이디 입력 → 실행
  2. 아래 2단계에서 다시 「카페24와 연결」
  3. 그래도 같은 오류면 Redirect URI 앞뒤에 공백이나 슬래시(/)가 더 붙지 않았는지 한 글자씩 대조 (위 복사 버튼을 쓰면 이 문제가 안 생깁니다)
그 밖에 저장이 안 되거나 오류가 나요

2 앱 정보 붙여 넣기

누르면 카페24 관리자 로그인 창이 뜹니다. 로그인 후 「허용」을 누르면 최근 35일 매출이 자동으로 들어오고 대시보드가 열립니다.

3 다음

대시보드 아래 「아이폰에서 보기」에서 QR 을 찍으면 아이폰에서 비밀번호 없이 열립니다. 몰이 더 있으면 이 화면을 다시 열어 같은 순서로 (같은 브라우저면 한 계정에 모입니다).