Shopee API 연동 가이드

상품 자동 업로드를 위한 완벽 가이드

Shopee Open Platform 설정 페이지 상품 업로드

API 발급 단계

1
Open Platform 가입
  1. open.shopee.com 접속
  2. 우측 상단 Console 클릭
  3. Shopee 셀러 계정으로 로그인
  4. 개발자 정보 입력 후 가입 완료
이미 셀러 계정이 있어야 합니다. 없다면 먼저 Shopee 셀러 센터에서 계정을 만드세요.
2
앱(App) 생성

Console → My Apps → + Add New APP 클릭

App Category Seller In House System 추천
본인 셀러용 앱 (가장 빠른 승인)
App Name 영문 이름 (예: MyShopTool)
App Description 영문 설명 (예: Product upload tool)
Test Redirect URL https://shopee-uploader-stg.pages.dev/
⚠️ 끝에 슬래시(/) 포함!
생성 완료 시 Test Partner ID와 Test Partner Key가 발급됩니다!
3
API 권한 신청

앱 상세 페이지 → API List 탭 → 각 API 옆 Apply 클릭

Shop API 필수 상점 정보 조회, 인증
Product API 필수 상품 등록/수정/삭제
Media Space API 필수 이미지 업로드
Order API 주문 관리 (선택)
승인까지 1~3일 소요 - 이메일로 결과 통보됩니다.

Go Live (실제 운영 전환)

4
Go Live 신청
왜 Go Live가 필요한가요?
• Test(Sandbox) = API 테스트만 가능
• Live = 실제 상품 업로드 가능!

앱 상세 페이지 → Go Live 탭 클릭

5
Product Brief 작성
Live version URL https://sho-pilot.com/shopee-upload.html
Test Username 테스트용 아이디 (예: testuser)
Shopee 심사팀이 접속해볼 계정
Test Password 테스트용 비밀번호
실제 비밀번호 X, 테스트용으로 별도 생성
Brief Introduction 필수 영문 500자 이내 - 아래 예시 복사 가능
Shopee Margin Calculator & Product Uploader This tool helps Shopee sellers: 1. Calculate profit margins with real-time exchange rates 2. Scrape products from Korean e-commerce sites (Naver, Coupang, Gmarket) 3. Bulk upload products to Shopee stores 4. Manage multiple Shopee shops in one dashboard Target users: Korean sellers who want to sell on Southeast Asian Shopee markets.
Screenshot 필수 PNG/JPG 1~3장
• 업로드 페이지 스크린샷
• 설정 페이지 스크린샷
6
Authorization 설정
Test Redirect URL https://shopee-uploader-stg.pages.dev/ ✓ 입력됨
Live Redirect URL 필수 https://sho-pilot.com/
⚠️ 프로덕션 도메인 입력! (스테이징 URL 아님)
IP Whitelist 🔴 반드시 OFF (비활성화)
Cloudflare Workers는 IP 고정 불가!
IP Whitelist를 ON으로 하면 API 호출이 차단됩니다. 반드시 OFF!

IP 입력란에 필수 표시가 뜨면 0.0.0.0 입력 (토글 OFF면 무시됨)

7
심사 완료 후 Live Key 입력
심사 기간: 1~5일 - 승인되면 이메일 통보
  1. 이메일에서 Live Partner Key 확인
  2. 설정 페이지 이동
  3. 환경을 Production으로 변경
  4. 새로운 Live Partner ID / Key 입력
  5. 저장 클릭

상점(Shop) 연동

8
Shop 연동 (OAuth 인증)

방법 1: 우리 앱에서 연동

  1. 상품 업로드 페이지 이동
  2. 쇼피 계정 연동하기 버튼 클릭
  3. Shopee 로그인 팝업에서 로그인
  4. 권한 승인 → 연동 완료!

방법 2: Shopee Open Platform에서 연동

  1. Open Platform Console → App List
  2. 앱 옆의 Authorize 클릭
  3. 연동할 Shop 선택 (체크)
  4. Confirm Authorization 클릭
9
CBSC 계정 (크로스보더 셀러) 연동
CBSC란?
Cross-Border Seller Center - 여러 국가 마켓을 하나의 계정으로 관리하는 시스템

CBSC 계정 연동 시 주의사항:

Main Account 사용 서브 계정(Sub Account)이 아닌 메인 계정으로 로그인해야 합니다.
Merchant 선택 "Authorize Merchant" 체크 후 원하는 Shop들을 선택합니다.
Authorization Period 365 Days 선택 (최대 1년)
CBSC 계정은 한 번 연동으로 모든 마켓 Shop이 연결됩니다! (SG, MY, TH, VN, PH, TW 등)

최종 체크리스트

✓
연동 완료 확인
모든 항목 완료! 이제 실제 Shopee 스토어에 상품을 업로드할 수 있습니다!
설정 상품 업로드