네이버 커머스API 연동 세팅 — 애플리케이션 등록·호출 IP·토큰, 자동화 준비물 정리

네이버 커머스API는 무엇이고 왜 필요한가요?

커머스API는 네이버가 스마트스토어 판매자와 솔루션사에 여는 API(Application Programming Interface — 프로그램끼리 데이터를 주고받는 약속된 창구)입니다. 판매자센터 화면에서 손으로 하던 상품 등록·가격 수정·재고 변경·주문 조회·발주 확인·송장 입력을 프로그램이 대신할 수 있게 해줍니다. 위탁판매처럼 상품 수가 많고 주문·품절이 매일 바뀌는 운영에서는 이 연동이 자동화의 출발점입니다.

커머스API로 자동화할 수 있는 영역

상품

등록·수정·가격·재고·판매중지

주문

신규 주문 조회·발주 확인

배송

송장 입력·발송 처리

문의

고객 문의 조회

세부 API 목록과 권한은 커머스API센터 공식 문서 기준입니다. 판매자센터 로그인이 필요한 일부 기능(엑셀 일괄등록 화면 등)은 API 대상이 아닙니다.

연동 세팅은 어떤 순서로 하나요?

커머스API 연동 5단계

커머스API센터 가입·로그인스마트스토어 판매자 계정으로 커머스API센터(apicenter.commerce.naver.com)에 접속합니다.

‘내 스토어 애플리케이션’ 등록내 스토어만 관리할 용도라면 내 스토어 애플리케이션으로 등록합니다. 등록하면 애플리케이션 ID와 시크릿이 발급됩니다.

API 호출 IP 등록애플리케이션 목록에서 대상 앱의 ‘API 호출 IP’에 호출할 서버의 공인 IP를 추가합니다(우측 상단 수정 버튼).

인증 토큰 발급 테스트규격에 맞는 요청으로 토큰을 받아 봅니다. 내 스토어 애플리케이션은 type을 SELF로 보냅니다.

읽기 API부터 호출상품 목록 조회처럼 아무것도 바꾸지 않는 API로 연결을 확인한 뒤, 등록·수정 API로 넘어갑니다.

메뉴 이름은 커머스API센터 개편에 따라 달라질 수 있습니다. 2026년 11월 기준 공식 저장소(commerce-api-naver) 안내를 따랐습니다.

API 호출 IP는 왜 등록하고, 어떤 규칙이 있나요?

커머스API는 미리 등록한 IP에서 온 요청만 받습니다. 시크릿이 유출되더라도 등록되지 않은 곳에서는 호출할 수 없게 막는 장치입니다. 공식 저장소의 안내 기준 규칙은 다음과 같습니다.

항목	규칙	실무 의미
IP 종류	IPv4만 지원	IPv6만 있는 환경에서는 호출 불가
개수	애플리케이션당 최대 3개	운영 서버·예비 서버·개발 환경 정도만
사설망	사설 IP 대역이면 NAT(외부로 나가는) IP 등록	내 PC의 192.168.x.x가 아니라 공인 IP
클라우드	유동 IP면 고정 IP(Static·Elastic IP) 사용 권장	서버 재시작마다 IP가 바뀌면 연동이 끊김
권장 대역	대한민국 할당 IP 대역 권장	한국 리전 서버 + 한국 대역 고정 IP

자동화 서비스를 쓸 때: 서비스 운영사의 서버가 대신 호출하므로, 운영사가 알려주는 서버 IP를 내 애플리케이션의 호출 IP에 추가합니다. 구매몬스터 자동화도 이 방식이며, 판매자의 비밀번호는 받지 않습니다.

인증 토큰은 어떻게 받나요? 규격을 어기면 어떻게 되나요?

API를 부르려면 먼저 애플리케이션 ID와 시크릿으로 만든 전자서명을 보내 인증 토큰을 받고, 이후 요청마다 그 토큰을 붙입니다. 네이버는 2025년부터 토큰 발급 요청 규격 검증을 강화했고, 2026년 8월 21일 재안내에서 다음을 다시 강조했습니다.

필수 값은 모두 요청 본문(payload)에 넣고, 형식은 x-www-form-urlencoded로 보낸다.
grant_type=client_credentials를 항상 포함한다.
type=SELF(내 스토어 애플리케이션)면 account_id를 넣지 않고, type=SELLER면 올바른 판매자 계정 ID를 넣는다.
규격을 어긴 애플리케이션은 이전 호출량과 상관없이 토큰 발급 API가 시간당 1회로 제한된다. 제한은 전날 요청 기준으로 매일 다시 판단한다.

# 개념 예시 — 실제 서명 생성 방법은 커머스API센터 문서를 따르세요
POST /external/v1/oauth2/token
Content-Type: application/x-www-form-urlencoded

client_id=발급받은ID
&timestamp=밀리초
&client_secret_sign=전자서명
&grant_type=client_credentials
&type=SELF
(실제로는 줄바꿈 없이 한 줄로 보냄)

토큰은 만료 시간이 있으므로 매 요청마다 새로 받지 말고, 받은 토큰을 재사용하다 만료가 가까울 때 갱신하는 구조가 좋습니다. 토큰을 너무 자주 요청하는 것도 제한의 원인이 됩니다.

자주 나는 오류와 해결법은?

증상	원인	해결
403 “호출이 허용되지 않은 IP” (GW.IP_NOT_ALLOWED)	호출한 서버 IP가 등록 안 됨	서버의 외부(Outbound) IP 확인 후 API 호출 IP에 추가
토큰이 가끔만 발급됨	요청 규격 위반으로 시간당 1회 제한	form-urlencoded·grant_type·type 규격 수정, 다음 날 해제 확인
어제까지 되다가 갑자기 403	클라우드 서버 재시작으로 IP 변경	고정 IP로 전환
인증 실패	시크릿 오타·재발급 후 미반영, 시간(timestamp) 오차	시크릿 재확인, 서버 시간 동기화

질문을 커머스API 공식 저장소의 ‘묻고 답하기’에 올릴 때는 시크릿, 유효한 토큰, 개인정보를 절대 붙이지 마세요. 공식 안내에 따르면 그런 글은 삭제되고 호출 정보가 무효화될 수 있습니다. 키 노출 일반 대응은 API 키 노출 시 위험과 조치를 참고하세요.

도매꾹·텔레그램 키는 무엇을 준비하나요?

위탁판매 자동화는 보통 스마트스토어(판매), 도매꾹·도매매(공급), 텔레그램(알림) 세 곳을 잇습니다. 커머스API 외에 두 가지가 더 필요합니다.

자동화 준비물 3종이 연결되는 구조

판매

네이버 커머스API

애플리케이션 ID·시크릿 + 호출 IP

→

공급

도매꾹 Open API 키

자동 발주는 Private API 승인 필요

→

알림

텔레그램 봇

봇에 /start를 먼저 보내야 메시지 수신

텔레그램 봇은 사용자가 먼저 대화를 시작해야 개인 메시지를 보낼 수 있습니다(텔레그램 공식 봇 튜토리얼).

도매꾹 Open API 키: 도매꾹 사업자 회원으로 발급합니다. 주문을 공급처에 자동으로 넘기는 자동 발주는 Private API 신청·승인이 필요하며, 승인 전에는 사람이 확인하고 발주하는 ‘발주 전 확인’ 방식으로 운영합니다.
텔레그램: 직접 봇을 만든다면 @BotFather에 /newbot으로 토큰을 받습니다. 자동화 서비스를 쓴다면 운영사 봇에 /start만 보내면 됩니다.

직접 연동을 만들어 운영해 보니

저는 구매몬스터 스토어 운영을 자동화하면서 커머스API 연동을 직접 만들었고, 같은 연결을 Claude 같은 AI 에이전트가 쓸 수 있도록 MCP 서버(@appmonster/mcp-naver-commerce)로도 묶었습니다. 구조를 정할 때 가장 먼저 따진 것은 코드가 아니라 호출 IP였습니다. 로컬 PC·클라우드 서버·개발용 환경은 외부 IP가 제각각이고 호출 IP는 3개까지만 등록되므로, 고정 IP를 가진 서버 한 곳에서만 호출하도록 단순하게 설계했습니다. 판매자가 호출 IP에 운영사 주소 하나만 추가하면 되는 이유가 이것입니다.

두 번째로 배운 것은 쓰기 API의 검증입니다. 엑셀은 한 행이 틀리면 그 행만 실패하지만, API는 잘못된 로직이 수백 개 상품을 한 번에 바꿀 수 있습니다. 그래서 가격·재고를 바꾸는 호출 앞에는 항상 “역마진인가, 변경 폭이 비정상인가”를 검사하는 단계를 둡니다.

직접 개발하기 어렵다면 — 맡기면 얼마·얼마나 걸리나

구매몬스터 스마트스토어 자동화를 쓰면 판매자는 본인 명의로 커머스API 애플리케이션을 등록해 ID·시크릿을 직접 입력하고, 호출 IP에 운영사 서버 주소를 추가하기만 하면 됩니다. 비밀번호와 키는 판매자가 본인 화면에 직접 입력하며, 운영사 화면에는 가려진 상태로만 보입니다. 키 3종 설정은 약 15분, 설치·서버·확장프로그램은 필요 없습니다.

상품	가격	등록 수·기간
스타터 셋업	490,000원	300개 · 영업일 3일
풀 셋업	990,000원	1,000개 · 영업일 5일 (미끼·수익형 구성, 전수 점검 1회)
월 운영 구독	월 99,000원 (준비 중)	주문 자동 발주·송장, 미판매 교체, 시즌 보충

주문은 수 분 간격으로 자동 동기화되며, 판매량과 수익은 보장하지 않습니다. 구매몬스터는 앱몬스터가 운영하는 서비스로 네이버·도매꾹과 제휴 관계가 아닙니다.

Q&A — 네이버 커머스API 자주 묻는 질문

네이버 커머스API는 누구나 쓸 수 있나요?

스마트스토어 판매자라면 신청할 수 있습니다. 커머스API센터에서 내 스토어 애플리케이션을 등록하면 ID와 시크릿이 발급됩니다.

커머스API 호출 IP는 몇 개까지 등록되나요?

애플리케이션당 최대 3개, IPv4만 됩니다. 사설망이면 외부로 나가는 공인(NAT) IP를 등록해야 합니다.

‘호출이 허용되지 않은 IP’ 오류는 어떻게 해결하나요?

호출 서버의 외부 IP를 API 호출 IP에 추가하면 됩니다. 클라우드 서버라면 IP가 바뀌지 않게 고정 IP를 쓰세요.

토큰 발급이 시간당 한 번밖에 안 돼요. 왜 그런가요?

요청 규격 위반으로 제한된 상태일 가능성이 큽니다. form-urlencoded 형식과 grant_type·type 값을 고치면 다음 날부터 해제될 수 있습니다.

커머스API 시크릿이 유출되면 어떻게 하나요?

즉시 재발급하세요. 호출 IP 제한이 있어 바로 악용되긴 어렵지만, 재발급 후 기존 시크릿을 쓰는 곳을 모두 바꿔야 합니다.

자동화 서비스를 쓰면 비밀번호도 줘야 하나요?

구매몬스터는 비밀번호를 받지 않습니다. 판매자가 본인 화면에 키를 직접 입력하고, 호출 IP에 운영사 서버만 추가합니다.

커머스API로 엑셀 일괄등록까지 대신할 수 있나요?

상품 등록·수정은 API로 할 수 있습니다. 다만 판매자센터 화면의 엑셀 일괄등록 기능 자체는 본인 로그인이 필요합니다.

출처

API 세팅은 15분, 나머지는 자동으로

커머스API·도매꾹·텔레그램 키 3종만 본인 명의로 입력하면 상품 선정·등록용 엑셀·주문 발주·송장·품절 정리가 자동으로 돌아갑니다. 스타터 셋업 490,000원·풀 셋업 990,000원, 월 운영 구독은 준비 중입니다. 판매량·수익은 보장하지 않습니다.

자동화 구독 보러가기 → 구매몬스터

실제 운영 스토어 예시: 구매몬스터 스토어