스마트스토어 연동 가이드

네이버는 카페24와 달리 판매자가 직접 한 번만 앱을 등록하면 됩니다(네이버 정책). 아래 순서대로 따라 하시면 됩니다. 어렵지 않아요.

⏱️ 약 5분이면 끝납니다. 한 번만 하면 다시 안 해도 됩니다.

🔑 준비물: 스마트스토어 로그인 정보 — 통합매니저(대표 운영자) 계정으로 진행하세요.

1

네이버 커머스 API 센터에 로그인

아래 버튼을 눌러 접속한 뒤, 평소 쓰는 스마트스토어 아이디로 로그인하세요.

처음 접속하는 경우 화면 안내에 따라 간단히 가입(약관 동의)만 하면 됩니다.

네이버 커머스 API 센터 열기 → (새 탭에서 열림)
2

‘내스토어 애플리케이션’ 등록 화면 열기

화면의 메뉴에서 [애플리케이션][내스토어 애플리케이션] 을 차례로 누른 다음, [애플리케이션 등록] 버튼을 누르세요.

💡 메뉴나 내 스토어가 안 보이면, 통합매니저 권한이 있는 계정으로 로그인했는지 확인하세요.

3

앱 정보 입력 + 주문 API 선택

  1. 스토어 선택 — 연동할 내 스토어를 고릅니다.
  2. 이름 입력 — 예: 주문 대시보드 연동 (그대로 적어도 됩니다)
  3. 설명 입력 — 예: HedgieLabs 주문 통합 (생략 가능)
  4. API 선택‘주문(판매자)’ 관련 API를 체크합니다.
가장 중요한 단계입니다. 주문 API를 체크하지 않으면 연결은 되는데 주문이 하나도 안 보입니다. 어떤 걸 골라야 할지 헷갈리면 주문·배송 관련 항목은 모두 체크해도 괜찮습니다. (나중에 ‘앱 수정’에서 변경할 수 있어요.)
4

‘API 호출 IP’ 칸이 보이면 입력 (없으면 건너뛰기)

대부분의 경우 이 칸은 없습니다. 등록 화면에 ‘API 호출 IP’라는 입력란이 보일 때만 채우면 됩니다.

보인다면, 연동 직전에 헤지랩스가 알려드리는 IP 주소를 넣어주세요. (본인 컴퓨터 IP가 아니라, 주문을 대신 불러오는 우리 서버 IP입니다.) 안 보이면 그냥 다음으로 넘어가세요.

5

등록 → ‘애플리케이션 ID’와 ‘시크릿’ 복사

[등록]을 누르면, 방금 만든 앱의 상세 화면에서 애플리케이션 ID시크릿(영문·숫자로 된 긴 문자열 2개)을 확인할 수 있습니다. 두 값을 복사해 두세요.

💡 이 두 값은 앱 상세 화면에서 언제든 다시 확인할 수 있으니, 잃어버려도 걱정 마세요.

6

대시보드에 붙여넣고 연결

  1. 설정 페이지로 이동합니다.
  2. 스마트스토어 카드에 애플리케이션 ID시크릿을 붙여넣습니다.
  3. [연결] 버튼을 누르면 자동으로 확인하고, 성공하면 첫 주문 동기화가 바로 시작됩니다.

🔒 입력한 키는 AES-256-GCM으로 암호화되어 저장됩니다. 화면이나 기록(로그)에 그대로 노출되지 않습니다.

🛟 막히면 여기를 보세요

‘내스토어 애플리케이션’ 메뉴나 내 스토어가 안 보여요
통합매니저(대표 운영자) 권한이 있는 계정으로 로그인했는지 확인하세요. 직원 계정에는 이 메뉴가 안 보일 수 있습니다.
연결은 됐는데 주문이 0건이에요
3단계의 ‘주문 API 선택’을 빠뜨렸을 가능성이 큽니다. 커머스 API 센터에서 앱을 ‘수정’해 주문 관련 API를 추가한 뒤 다시 동기화하세요.
연결 버튼을 눌렀는데 실패해요
ID·시크릿에 빈칸이나 줄바꿈이 섞이지 않았는지 확인하세요(앞뒤 공백 주의). 그래도 안 되면 고객센터로 문의해 주시면 함께 확인해 드립니다.