네이버 스마트스토어 연동

스마트스토어 커머스 API로 본인 스토어의 상품을 자동 동기화할 수 있습니다.

준비

• 스마트스토어센터 셀러 계정
• 사업자 등록 + 통신판매업 신고 (스마트스토어 운영 기본 요건)
• 약 3분

1단계 — API 설정 활성화

1. 스마트스토어센터 로그인
2. 좌측 메뉴 → 판매자정보 → API 설정
3. 사용 신청 → 즉시 발급 (별도 승인 없음)

2단계 — Client ID / Secret 복사

API 설정 화면에 두 값이 노출됩니다.

| 값 | 형식 | |---|---| | Client ID | 영숫자 32자 내외 | | Client Secret | 영숫자 32자 내외 |

Client Secret은 발급 직후 한 번만 노출될 수 있습니다 (스마트스토어 정책 변경 시). 반드시 복사하세요.

3단계 — CurateAI에서 연결

/dashboard/new Step 1에서 네이버 스마트스토어 연동 카드 클릭.

Client ID와 Client Secret을 붙여넣고 연결하고 상품 가져오기.

내부 동작:

1. CurateAI 서버가 POST https://api.commerce.naver.com/external/v1/oauth2/token 호출 → access token 발급 (3시간 유효, 메모리 캐시)
2. POST /external/v1/products/search → 상품 목록 최대 50개
3. Client Secret은 AES-256-GCM으로 암호화 저장

보안

• 평문 저장 절대 안 함 — DB에는 암호화된 payload만
• 응답에서 secret 마스킹 (xxxx***yyzz)
• 사용자별 격리: (user_id, "naver") UNIQUE 제약
• ?platform=naver DELETE로 연결 해제

문제 해결

naver oauth 401

• Client ID/Secret이 정확한지 확인
• API 설정이 활성 상태인지 확인 (비활성화하면 즉시 발급된 토큰 무효)

상품 0개

• 스마트스토어센터에서 판매 중 상태인 상품이 있는지 확인
• 상품 등록 후 검색 색인까지 5-10분 지연 가능

429 Too Many Requests

• 네이버 커머스 API rate limit. CurateAI는 5초 timeout + 1회 재시도. 잠시 후 다시 시도.

참고

• 네이버 커머스 API 개발 가이드
• 스마트스토어센터 API 설정 도움말