스마트스토어 연동 가이드

네이버는 판매자가 직접 앱을 한 번 등록해야 합니다. 아래 순서대로 따라 하시면 됩니다.

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

준비물: 스마트스토어 통합매니저(대표운영자) 계정, 인증번호를 받을 이메일.

  1. API 센터 로그인
  2. 개발업체계정 만들기
  3. 앱 등록·IP
  4. 주문 API 추가
  5. 키 입력
1

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

네이버 화면

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

처음이면 네이버 커머스ID 가입 화면이 먼저 나올 수 있습니다. 쓰던 아이디 그대로 진행하시면 됩니다.

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

이렇게 되면 성공: 로그인이 되어 API 센터 첫 화면이 열립니다.

2

개발업체계정 만들기 (처음 한 번만)

네이버 화면

로그인하면 개발업체계정 권한을 보유하지 않은 회원입니다 안내가 나올 수 있습니다. 처음이면 정상이니 [계정생성] 누르세요.

  1. 계정명: 14자 이내로 짓습니다. 나중에 2번까지 고칠 수 있습니다.
  2. 장애대응 이메일: 이메일을 넣고 [인증] 누른 뒤, 메일로 온 인증번호를 아래 칸에 입력합니다.
  3. 약관 동의: 맨 위 모두 동의 하나만 눌러도 필수 2개가 함께 체크됩니다.

이미 계정이 있으면 이 화면은 나오지 않습니다. 바로 다음 단계로 가세요.

이렇게 되면 성공: 계정이 만들어지면 애플리케이션 메뉴를 쓸 수 있습니다.

3

애플리케이션 등록 (이름, 설명, IP)

네이버 화면

메뉴에서 [애플리케이션][내스토어 애플리케이션] [애플리케이션 등록] 누른 뒤 아래 값을 복사해 넣으세요. 맨 위 스토어는 여러 개면 고르시고, 하나면 이미 채워져 있습니다.

이름주문 대시보드 연동
설명HedgieLabs 주문 통합
API호출 IP43.201.181.155

IP는 붙여넣은 뒤 오른쪽 [추가] 버튼을 눌러야 등록됩니다. 칸 제목이 API호출 IP (1/3)으로 바뀌면 등록된 것입니다.

내 컴퓨터 IP가 아니라 위의 헤지랩스 고정 IP가 맞습니다. 헤지랩스가 네이버를 대신 호출하는 주소입니다.

이렇게 되면 성공: IP 칸 아래에 43.201.181.155 줄이 생기면 성공입니다.

4

주문 판매자 API 추가 후 등록

네이버 화면

화면을 아래로 내리면 API 그룹이 있습니다. 전체 API 그룹 목록에서 아래 항목을 찾아 [추가] 누르세요.

네이버 화면 예시

주문 판매자

주문조회,발주/발송처리,취소,교환 등…

추가

이미 위쪽 내 API 그룹에 들어 있으면 그대로 두시면 됩니다.

  1. 맨 아래 인증 토큰 표준 스펙을 확인하였습니다 항목에 체크합니다.
  2. [등록] 버튼을 누릅니다.
가장 중요한 단계입니다. 이걸 빠뜨리면 연결은 되는데 주문이 하나도 안 보입니다. 문의나 상품, 정산 같은 다른 그룹은 주문 집계에 필요 없습니다.

이렇게 되면 성공: 내 API 그룹 쪽으로 항목이 올라가면 성공입니다.

5

ID와 시크릿을 대시보드에 붙여넣기

헤지랩스 설정 화면
  1. 등록된 앱 화면에서 애플리케이션 ID시크릿을 복사합니다. 영문과 숫자로 된 긴 문자열 2개입니다.
  2. 설정 페이지의 스마트스토어 카드에 두 값을 붙여넣습니다.
  3. [연결] 누르면 키가 암호화되어 저장되고, 1분 안에 첫 동기화가 시작됩니다.

두 값은 앱 화면에서 다시 확인하거나 재발급할 수 있으니, 잃어버려도 처음부터 다시 할 필요는 없습니다.

이렇게 되면 성공: 스마트스토어 카드에 연결됨이 표시되고, 1~2분 안에 주문이 나타나기 시작합니다.

연결 후 데이터가 차오르는 순서

  • 최근 주문은 1~2분 안에 대시보드에 표시됩니다.
  • 과거 주문도 자동으로 차례차례 불러옵니다. 주문량에 따라 시간이 걸릴 수 있으니 그대로 두시면 됩니다.

막히면 여기를 보세요

개발업체계정 권한이 없다고 나와요
처음이면 정상입니다. [계정생성] 눌러 2단계를 진행하세요. 눌러도 진행이 안 되면 통합매니저 계정이 아닐 수 있습니다.
메뉴나 스토어가 안 보여요
통합매니저 권한이 있는 계정으로 로그인했는지 확인하세요. 직원 계정에는 이 메뉴가 보이지 않습니다.
연결은 됐는데 주문이 0건이에요
4단계의 주문 판매자 그룹을 빠뜨렸을 가능성이 큽니다. 커머스 API 센터에서 앱을 수정해 이 그룹을 추가한 뒤 다시 동기화하세요.
IP를 넣었는데 오류가 나요
[추가] 버튼을 눌러 목록에 줄이 생겼는지 확인하세요. 방금 등록했다면 반영에 시간이 걸릴 수 있는데, 그동안 자동으로 다시 시도하므로 반영되면 저절로 연결됩니다.
연결 버튼을 눌렀는데 실패해요
ID와 시크릿에 빈칸이나 줄바꿈이 섞이지 않았는지 확인하세요. 그래도 안 되면 고객센터로 문의해 주시면 함께 확인해 드립니다.

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