네이버 커머스 API, 애플리케이션 등록 5단계와 연동 범위표
네이버 커머스 API로 할 수 있는 일을 상품 · 주문 · 발송 · 정산 · 문의 다섯 업무로 나눈 범위표, 내스토어 애플리케이션 등록부터 토큰 발급까지 5단계, 직접 개발과 연동 솔루션 비교, 호출 허용량 · IP · 타임스탬프처럼 개발 전에 확인할 한도와 오류를 공식 문서 기준으로 정리했습니다.

네이버 커머스 API는 커머스API센터에 내스토어 애플리케이션을 등록하고, 거기서 받은 애플리케이션 ID · 시크릿으로 인증 토큰을 발급받아 쓰는 스마트스토어 판매자용 연동 창구입니다. 상품 등록 · 수정, 주문 조회 · 발송 처리, 정산 내역, 고객 문의까지 자체 프로그램이나 시트와 이을 수 있습니다. 다만 애플리케이션 하나는 스토어 하나에만 연결되고, 호출할 서버의 IP를 미리 등록해야 하며, API마다 1초당 호출 횟수가 정해져 있습니다. 이 세 가지를 먼저 확인하고 설계를 시작하세요.
네이버 커머스 API로 무엇을 연동할 수 있나요
스마트스토어센터에서 손으로 하던 일의 대부분이 API(프로그램끼리 데이터를 주고받는 창구)로 열려 있습니다. 아래는 공식 기술 지원 저장소의 안내와 자주 묻는 질문을 업무별로 묶은 것입니다. 오른쪽 열은 설계할 때 처음부터 반영할 점입니다.
| 업무 | API로 하는 일 | 설계할 때 반영할 점 |
|---|---|---|
| 상품 | 상품 등록 · 조회 · 수정, 옵션별 재고 변경, 판매 상태 변경 | 원상품 번호와 채널상품 번호가 따로 있고, 전체 수정 API는 요청에 없는 정보를 지우는 방식 |
| 주문 | 새로 들어왔거나 상태가 바뀐 주문 조회, 주문 상세 조회 | 한 번에 조회하는 시간 범위는 최대 24시간 |
| 발송 · 클레임 | 발송 처리, 취소 · 반품 · 교환 처리 | 발송 처리 뒤의 취소는 반품 절차로 진행 |
| 정산 | 건별 정산 내역 조회 | 정산 기준일(구매확정 · 반품 완료 등으로 정산 대상이 확정된 날)과 예정일 · 완료일을 구분 |
| 문의 | 고객 문의 조회, 답변 등록 · 수정 | 일부 API는 주문 판매자 API 그룹 권한이 함께 있어야 호출됨 |
주문 수집은 두 API를 이어 씁니다. 변경 상품 주문 내역 조회로 새 주문이나 상태가 바뀐 주문의 번호를 받고, 그 번호로 상품 주문 상세 내역 조회를 불러 내용을 채웁니다. 공식 안내는 직전 조회의 끝 시각과 이번 조회의 시작 시각을 같게 하거나 조금 겹치게 잡아야 주문이 빠지지 않는다고 적고 있습니다. 여러 프로그램을 잇는 일반 순서는 API 연동 진행 6단계와 같습니다.
애플리케이션 등록은 어떤 순서인가요
판매자가 직접 쓰는 애플리케이션은 내스토어 애플리케이션이고, 애플리케이션 1개가 스마트스토어 계정 1개와 짝을 이룹니다. 스토어가 둘이면 애플리케이션과 토큰도 각각 둡니다.
| 단계 | 할 일 | 확인할 것 |
|---|---|---|
| 1. 애플리케이션 만들기 | 커머스API센터에서 운영 중인 스토어의 내스토어 애플리케이션을 만듭니다 | 스토어 1개당 애플리케이션 1개 |
| 2. API 그룹 고르기 | 상품 · 주문 · 문의처럼 쓸 API 그룹을 켭니다 | 그룹에 없는 API를 부르면 권한 오류 |
| 3. 호출 IP 등록 | API를 부를 서버의 바깥쪽 IP를 넣습니다 | IPv4 최대 3개, 클라우드 서버는 고정 IP |
| 4. ID · 시크릿 보관 | 애플리케이션 ID와 시크릿을 서버 설정에만 둡니다 | 노출되면 시크릿을 바로 재발급 |
| 5. 토큰 발급과 첫 호출 | ID · 시크릿 · 타임스탬프로 전자서명을 만들어 인증 토큰을 받고, 주문 조회 한 건으로 시험합니다 | 토큰은 스토어별 · 애플리케이션별로 따로 |
5단계의 전자서명은 애플리케이션 ID와 밀리초 타임스탬프로 만든 문자열을 bcrypt(비밀번호 해시 방식)로 해시한 뒤 Base64로 인코딩한 값입니다. 시크릿 자체는 요청에 넣지 않고, 내스토어 애플리케이션은 발급 유형을 SELF로만 씁니다. 정확한 문자열 조합은 커머스API 문서 인증 항목의 예시 데이터로 맞춰 보세요. 공식 SDK(연동용 묶음 코드)는 없고, 언어마다 있는 bcrypt 라이브러리로 구현합니다.
직접 개발과 연동 솔루션은 어떻게 고르나요
주문을 자기 시스템에 쌓아 다른 데이터와 섞어 쓸 계획이면 직접 개발, 주문 수집 · 송장 · 재고처럼 흔한 업무만 필요하면 솔루션이 빠릅니다. 네이버는 직접 연동이 어려우면 API 대행사나 커머스솔루션마켓의 솔루션, 외부 개발사를 이용하라고 안내합니다.
| 기준 | 직접 개발 | 연동 솔루션 |
|---|---|---|
| 연결 방식 | 내스토어 애플리케이션으로 직접 토큰 발급 | 스마트스토어센터의 API 정보 탭에서 대행사를 지정하거나, 솔루션마켓에서 사용을 승인 |
| 인증 정보 | 시크릿을 자기 서버에 보관 | 정식 수단을 쓰는 솔루션은 시크릿 없이 연결 |
| 화면 · 기능 | 사내 시트 · 재고 프로그램 · 관리자 화면에 맞춰 만듦 | 솔루션이 정한 화면과 기능 안에서 씀 |
| 드는 것 | 개발비, 고정 IP 서버, API 변경 대응 | 월 이용료와 기능 범위 확인 |
| 맞는 경우 | 스토어 데이터를 다른 업무 시스템과 합칠 때 | 채널 여러 곳의 주문을 한 화면에서 처리할 때 |
네이버 안내에 따르면 정식 수단을 쓰는 솔루션은 판매자의 애플리케이션 인증 정보 없이 연결되도록 설계되어 있습니다. 솔루션을 고를 때는 연결 방식이 위 표의 정식 수단인지부터 보세요. 스토어 운영의 기본 설정은 스마트스토어 시작하기에 정리되어 있습니다.
개발 전에 확인할 한도와 오류는 무엇인가요
- 호출 허용량: 애플리케이션별로, API마다 1초당 호출 횟수를 셉니다. 넘으면 처리하지 않고 HTTP 429를 돌려주므로, 잠시 기다렸다 다시 부르는 로직을 처음부터 넣습니다.
- 호출 IP: 등록하지 않은 IP에서 부르면 403과 함께 허용되지 않은 IP라는 응답이 옵니다. IP가 수시로 바뀌는 클라우드 서버는 고정 IP를 붙이고, 국내 리전을 권장합니다.
- 타임스탬프: 밀리초 단위 13자리여야 하고, 호출 시각 기준 5분 안의 값만 받습니다. 서버 시계가 어긋나면 토큰 발급이 실패하니 시간 동기화를 켭니다.
- 요청 형식: 토큰 발급 요청은 application/x-www-form-urlencoded 형식만 받고, 다른 형식이면 415가 옵니다.
- 권한: 401과 함께 권한이 없다는 응답이 오면 애플리케이션 상세 화면의 API 그룹을 먼저 봅니다.
- 토큰 유효 시간: 사용자가 바꿀 수 없고, 발급 응답에 담긴 유효 시간을 기준으로 다시 받습니다.
자주 묻는 질문
구글 시트에서 네이버 커머스 API를 바로 불러도 되나요?
공식 안내는 인증 정보와 토큰, 구매자 개인정보를 보호하려고 커머스API 호출을 백엔드(사용자에게 보이지 않는 서버 쪽)에서만 처리하라고 권합니다. 호출 IP도 등록해야 하므로, 고정 IP 서버가 주문을 받아 시트로 넘기는 구조로 만드세요.
애플리케이션 시크릿이 노출되면 어떻게 하나요?
커머스API센터의 내스토어 애플리케이션 화면에서 시크릿을 재발급합니다. 재발급하면 이전 시크릿은 바로 쓸 수 없으므로, 서버의 전자서명 코드가 새 시크릿을 읽는지 같은 날 확인하세요. 애플리케이션 ID는 바뀌지 않습니다.
발송 처리한 주문을 취소로 바꿀 수 있나요?
발송 처리 전에는 취소 요청, 발송 처리 뒤에는 반품 요청으로 나뉩니다. 연동 프로그램의 주문 상태도 이 기준으로 나눠 두면 클레임 처리 화면이 스마트스토어와 어긋나지 않습니다.
네이버 커머스 API 연동을 외주로 맡길 때 무엇을 정하나요?
연동할 업무(주문 · 발송 · 상품 · 정산 · 문의 가운데 무엇), 주문을 모으는 주기, 데이터를 쌓을 곳과 그 위에 만들 화면, 서버와 고정 IP를 누가 준비할지를 정하세요. 네이버는 애플리케이션 인증 정보를 제3자에게 주는 것을 약관 위배 소지로 안내하므로, 시크릿은 판매자가 직접 운영 서버 설정에 넣는 방식으로 합의해 두세요. 비용은 업무 수와 클레임 같은 예외 처리 범위, 화면 개발 여부로 정해지며, 이 목록을 그대로 보내면 API 연동 개발 견적을 같은 기준으로 받을 수 있습니다.
오늘 할 일
연동하고 싶은 업무를 주문 · 상품 · 정산 가운데 하나로 좁혀 보세요.
이어서 읽기 — 택배 API, 송장 발급 · 배송 조회 연동 방식 비교



