쿠팡 Wing API 키 발급 방법

📚 가이드 글 판매자로켓 시작하기 → · 입고 A to Z → · 자주 묻는 질문 →

💡 하나의 쿠팡 ID에서 여러 대행사(연동업체)를 이용하시는 경우라면? 확인하기 →

API 키 발급

해당하는 경우를 선택하세요

우측 상단 이름 클릭 → 추가판매정보 선택

Wing 우측 상단의 업체 이름 또는 대표자명을 클릭하면 메뉴가 펼쳐집니다.
목록에서 "추가판매정보"를 클릭합니다.

▲ 빨간 박스 안의 "추가판매정보" 클릭

"API Key 발급 받기" 버튼 클릭

추가판매정보 페이지에서 OPEN API 키 발급 섹션을 찾아 버튼을 클릭합니다.

▲ 빨간 원으로 표시된 "API Key 발급 받기" 클릭

키의 사용 목적: OPEN API 선택 → 확인

팝업이 나타나면 "OPEN API"를 선택하고 "확인"을 클릭합니다.

▲ "OPEN API" 선택 (빨간 원 표시) → 확인 클릭

⚠️ 목록의 다른 연동 솔루션 항목이 아니라 반드시 "OPEN API"를 선택해야 합니다.

약관 두 가지 모두 체크 → "약관 동의 및 Key 발급받기" 클릭

약관 동의 팝업에서 아래 두 가지를 모두 체크합니다.

✅ API 이용 약관에 동의합니다.
✅ 카테고리 자동 매칭 서비스 이용에 동의합니다.

▲ 두 약관 모두 체크 후 파란색 "약관 동의 및 Key 발급받기" 클릭

업체 입력 방식: 자체개발(직접입력) 선택 → 아래 값 입력 → 확인

업체 입력 방식에서 "자체개발(직접입력)"을 선택하고, 아래 값을 그대로 복사해서 붙여넣으세요.

📋 아래 내용을 그대로 복사해서 붙여넣으세요

업체명 코어팩토리

URL https://stockloop.co.kr

IP 주소 54.180.169.15

⚠️ 쿠팡은 연동정보 수정 횟수를 제한합니다. 한 번에 정확히 입력하세요.

그림의 업체명·URL·IP 가 실제로 넣을 값입니다(위 복사 칸과 같음)

🚨 필수! — 로켓그로스 상품 생성 API 이용 및 검수 기준 동의 클릭

업체 정보 입력이 끝나면 OPEN API 키 발급 영역 우측의 「로켓그로스 상품 생성 API 이용 및 검수 기준 동의」 버튼을 반드시 클릭해야 합니다.
이 동의 없이는 판매자로켓 상품 관련 API 기능이 제한됩니다.

▲ 빨간 원 안의 버튼 클릭

버튼 클릭 시 동의 팝업이 열립니다. 내용을 확인한 후 검수 기준 확인 필수 체크박스에 체크하고 "동의합니다"를 클릭하세요.

✅ 버튼이 "이미 동의 하셨습니다."로 표시되면 완료입니다. 다시 누르지 마세요.

⏱️ 수정사항 반영까지는 최대 30분이 걸릴 수 있습니다.

🔄 유효기간 이후 키를 재발급해주세요. 재발급 시 시크릿키(Secret Key)가 변경됩니다. 변경 후 스톡루프 설정에서도 새 키로 업데이트해 주세요.

🎉 모든 절차가 완료됐습니다! 이제 발급된 업체코드 · Access Key · Secret Key를 STEP 2에서 스톡루프에 입력하면 됩니다.

💡 이미 쿠팡 Wing에서 다른 솔루션(예: 플레이오토 등)으로 API 키를 발급받은 경우입니다.
새로 발급하지 않고 연동 정보 수정에서 IP 주소 칸 맨 뒤에 스톡루프 IP만 추가합니다.
⚠️ 그대로 두세요: 기존 사용 목적 · 연동업체 · 업체명 · URL · Vendor ID · Access Key · Secret Key · 기존 IP는 하나도 바꾸지 않습니다.
기존 IP를 지우고 우리 IP만 입력하면 기존 솔루션 연동이 끊깁니다!

⚡ 시작 전 준비 — 기존 솔루션의 쿠팡 연동 IP 확인

IP 주소는 기존 솔루션 IP + 우리 IP를 쉼표(,)로 함께 입력해야 합니다.
기존 솔루션 IP를 먼저 확인해 두세요.

📌 기존 솔루션(예: 플레이오토, 사방넷 등) 고객센터에 문의하여
"쿠팡 Wing 연동 IP가 무엇인가요?"라고 물어보세요.
확인 후 메모해 두었다가 Step 3에서 함께 입력합니다.

💡 입력 형식 예시 (쉼표 뒤 공백 포함):
기존솔루션IP, 54.180.169.15
예) 기존IP_A, 54.180.169.15 · 기존 IP 가 여럿이면 모두 그대로 두고 맨 뒤에만 추가

우측 상단 이름 클릭 → 추가판매정보 선택

Wing 우측 상단의 업체 이름 또는 대표자명을 클릭 후 "추가판매정보"를 클릭합니다.

▲ CASE 1과 동일 — "추가판매정보" 클릭

기존 발급된 키 확인 → 연동 정보 "수정" 버튼 클릭

이미 API 키가 발급된 경우 아래 화면처럼 테이블에 기존 키가 표시됩니다.
하단의 연동 정보 → "수정" 버튼을 클릭합니다.

▲ 빨간 원으로 표시된 "수정" 버튼 클릭

⚠️ 키를 재발급하면 기존 연동된 서비스(플레이오토 등)의 API 연결이 끊길 수 있습니다.
반드시 "수정" 버튼을 사용하세요.

IP 주소 칸 맨 뒤에 스톡루프 IP만 추가 → 확인

"OPEN API 키 수정" 팝업이 열리면 다른 칸은 손대지 말고 IP 주소 칸만 고칩니다.
기존 IP는 지우지 말고, 맨 뒤에 쉼표(,)를 붙여 스톡루프 IP만 추가한 뒤 "확인"을 클릭합니다.

🛑 그대로 두세요 — 사용 목적 · 업체 입력 방식 · 연동업체 · 업체명 · URL 은 지금 값 그대로입니다. 스톡루프 값으로 바꾸지 않습니다.
Vendor ID · Access Key · Secret Key 도 지금 것을 그대로 쓰고, 새 키를 발급받지 않습니다.

📋 IP 주소 칸 맨 뒤에 추가할 값

IP 주소

54.180.169.15

⚠️ Wing 입력 칸의 기존 IP 는 그대로 두고 맨 뒤에 쉼표(,)를 붙여 우리 IP 를 더하세요.
입력 형식: 기존 IP, 54.180.169.15
예) 기존IP_A, 54.180.169.15 · 기존 IP 가 여럿이면 모두 그대로 두고 맨 뒤에만 추가

⚠️ 쿠팡은 연동정보 수정 횟수를 제한합니다. 한 번에 정확히 입력하세요.

그림의 ‘기존IP_A’ 자리는 내 화면에 이미 있는 IP 그대로 — 맨 뒤에 스톡루프 IP 만 더합니다

✅ 확인 버튼을 누르면 IP 주소만 업데이트됩니다. 이어서 아래 4단계 동의를 확인한 뒤 STEP 2에서 기존 업체코드 · Access Key · Secret Key를 스톡루프에 입력하면 완료입니다.

🚨 필수! — 로켓그로스 상품 생성 API 이용 및 검수 기준 동의 확인

IP 추가가 끝나면 OPEN API 키 발급 영역 우측의 「로켓그로스 상품 생성 API 이용 및 검수 기준 동의」 버튼을 확인하세요. CASE 1 의 6단계와 같은 버튼입니다.

버튼 클릭 시 동의 팝업이 열립니다. 내용을 확인한 후 검수 기준 확인 필수 체크박스에 체크하고 "동의합니다"를 클릭하세요.

✅ 버튼이 "이미 동의 하셨습니다."로 표시되면 완료입니다. 다시 누르지 마세요.

⏱️ IP 수정사항 반영까지는 최대 30분이 걸릴 수 있습니다.

스톡루프에 API 키 입력

복사한 키를 앱 또는 웹에서 입력하면 연동이 완료됩니다

설정 화면에서 API 키 입력

스톡루프(/app)에서 ⚙️ 설정 → 쿠팡 샵 관리 → ＋ 새 샵 추가를 누르고 샵 이름과 API 키를 입력합니다.

🔌 스톡루프 — API 키 입력 필드

Vendor ID → Wing 업체코드 (예: A000XXXXX) Wing 업체코드

Access Key → 오픈 API 관리에서 발급된 Access Key Access Key

Secret Key → 오픈 API 관리에서 발급된 Secret Key Secret Key

등록 — 연결 테스트는 자동으로 한 번

세 가지 키를 모두 입력한 후 등록을 누릅니다. 등록이 되면 스톡루프가 그 샵의 연결 테스트를 자동으로 한 번 실행합니다.
샵 등록 및 연결 확인 완료 메시지가 표시되면 완료입니다.

⚠️ 샵은 등록됐지만 연결 테스트에 실패했어요가 보이면 샵은 그대로 남아 있습니다. 아래 체크 사항을 확인하고(키가 틀렸다면 샵 목록의 키 변경) 샵 목록의 연결 테스트 버튼으로 다시 확인하세요.

🎉 연결 성공 후 우상단 🔄 판매자로켓 동기화를 클릭하면 쿠팡 Wing의 상품 목록과 판매 데이터를 바로 불러올 수 있습니다!

💡 연결 실패 시 체크 사항:
1. Vendor ID가 A000으로 시작하는지 확인
2. Access Key / Secret Key에 공백이 없는지 확인
3. 쿠팡 Wing에서 API 키가 활성화 상태인지 확인
4. Wing 연동 정보의 IP 주소에 스톡루프 IP가 들어 있는지 확인 — 반영까지 최대 30분

🎊

API 키 설정 완료!

이제 스톡루프로 재고 현황, 판매 데이터, 엑셀 리포트를 한 번에 관리할 수 있습니다.

← 앱으로 돌아가기

🚀 첫 시작

회원가입 → 로그인 → 샵 등록까지 3분이면 완료됩니다.

회원가입

stockloop.co.kr 첫 화면에서 무료로 시작 클릭 → 네이버 로그인 · 카카오 로그인 · Google 계정으로 로그인 또는 아이디로 가입하기(휴대폰 인증 · 사업자등록번호 · 약관 동의). 카드 등록 없이 가입 즉시 바로 이용할 수 있습니다.

로그인

가입한 방법(소셜 또는 아이디)으로 로그인. 첫 화면은 대시보드(/app#dashboard).

Wing API 키 발급

위 페이지(🔑 Wing API 키 발급)의 CASE 1 또는 CASE 2 안내에 따라 쿠팡 Wing 에서 Vendor ID / Access Key / Secret Key 3종 발급.

샵 등록

⚙️ 설정 → 쿠팡 샵 관리 → ＋ 새 샵 추가 클릭 → 샵 이름 · 3종 키 입력 → 등록. 등록되면 연결 테스트가 자동으로 한 번 돈다. Wing 측 IP 등록 반영까지 최대 30분 소요.

💡 팁 — 여러 쿠팡 계정을 한 스톡루프 에서 관리하시려면 ＋ 새 샵 추가로 추가 등록할 수 있습니다. 헤더의 샵 선택 드롭다운에서 샵 전환.

⚠️ 주의 — 동일 Access Key/Vendor ID 는 본인 다른 샵 또는 다른 계정에서 사용 중이면 등록 차단됩니다.

대시보드로 이동 →

🔄 판매자로켓 동기화

쿠팡 판매자로켓 데이터를 가져와 권장 입고 수량을 자동 계산합니다.

동기화 실행

우상단 🔄 판매자로켓 동기화 클릭 → 약 1~2분 소요. 완료 시 SKU 목록 + 재고/판매 데이터 표시.

권장 입고 수량 자동 계산

판매량 · 현재고 · 상품 정보를 가져와 권장 입고 수량을 자동 계산합니다.

회전 분류 확인

재고현황 상단 4 카드(잘팔리는 / 보통 / 천천히 / 안팔리는) + 행별 분류 배지 + 권장수량 표시. 카드 클릭 시 표 필터링.

멀티샵

헤더에서 샵을 선택한 뒤 각 샵별로 동기화합니다.

💡 팁 — ⚙️ 설정 → 회전율 분류 기준값 카드에서 분류 기준을 조정하고 기준값 저장을 누릅니다.

재고현황으로 이동 →

📦 입고하기

입고 화면의 4단계 흐름 — 🛒 카트 → 📋 입고등록 → ✅ 입고확정 → 📦 완료. Wing 39컬럼 양식은 스톡루프가 자동으로 채워 드립니다.

권장수량 적용 → 카트에 담기

재고현황에서 상품을 체크하고 ✅ 권장수량 적용(또는 개별 입고수량 입력) → 입고하기 버튼으로 입고 카트에 담습니다.

카트 → 입고등록

🛒 입고 카트에서 담은 SKU를 체크해 입고하기 (선택분) →를 누르면 입고등록 단계로 넘어갑니다.

입고표 다운로드 → Wing 업로드

📋 입고등록 — Wing 업로드 대기 패널에서 유통/소비기한을 확인·입력하고 입고표(Wing 39컬럼 양식)를 내려받아 쿠팡 Wing 입고 페이지에 업로드합니다. 스톡루프는 입고 수량 · 유통(소비)기한만 자동 입력하고 나머지 원본 값은 그대로 보존합니다.

확정 준비

항목을 체크해 ① 확정 준비 (선택분) →를 누르면 입고확정 단계로 넘어갑니다.

입고 확정 (재고 차감)

✅ 입고확정 — 확정 시 재고 차감 패널에서 ② 입고 확정 (재고 차감)을 누르면 창고 재고가 차감되고 도착 대기로 넘어갑니다.

완료

📦 완료 — 입고 이력 패널 — 동기화에서 재고가 늘면 자동으로 도착 처리되고, 필요하면 도착·취소를 직접 누를 수 있습니다.

⚠️ 주의 — Wing 양식은 다운로드 시점마다 갱신됩니다. 반드시 매번 새로 다운로드 받아서 스톡루프 에 업로드한 후, 스톡루프 가 반환한 엑셀을 Wing 에 업로드해야 합니다.

💡 팁 — 직전에 입력한 소비기한은 회색으로 표시되어 클릭 한 번으로 다시 채울 수 있습니다.

입고 화면으로 →

💰 마진 계산기

판매가/원가/수수료 입력만으로 실수익을 추정합니다.

계산기 진입

사이드바 마진 계산기 메뉴 클릭. URL: /margin

기본 입력

판매가(원), 원가(원) 입력 — 수수료율은 SKU별 쿠팡 카테고리 자동 매핑으로 적용되며(직접 지정 가능), 로켓 입출고비·배송비는 SKU 부피/중량 등급으로 자동 차감됩니다.

결과 해석

결과 카드에 예상 실수익, 마진율, 손익분기 판매량 표시. 마진율이 음수이면 빨간색 경고.

💡 팁 — 90일 실 정산 데이터(revenue-history) 연동이 제공됩니다. 재고현황 마진율·역마진 표시도 같은 기준을 사용합니다.

마진 계산기로 →

🏷️ 바코드 / 라벨

3가지 모드 — 단일 바코드, 재고 상품 바코드 시트, 쿠팡 Wing PDF → 라벨 엑셀 변환.

① 단일 바코드 생성 SKU 입력 후 롤 라벨 PDF 다운로드 (60×40mm 기본).

② 재고 상품 바코드 시트 전체 SKU 바코드를 한 번에 PDF 로 생성.

③ 쿠팡 Wing PDF → 라벨 엑셀 입고 라벨 PDF를 업로드하면 라벨 엑셀로 자동 변환.

💡 팁 — 입고 카트 기준으로 바코드·상품명·수량·소비기한을 표에서 직접 편집해 폼텍 A4 라벨 PDF 도 만들 수 있습니다.

바코드 페이지로 →

❓ 자주 묻는 질문 (FAQ)

사장님들이 자주 문의하시는 12 가지 질문 정리

월 사용료가 얼마인가요?

쿠팡 계정 1개 · 판매자로켓 SKU 999개까지는 기간 제한 없이 무료입니다. 계정이 2개 이상이거나 SKU가 1,000개 이상이면 프로 플랜 월 49,000원(VAT 별도 · 3개월 약정 시 3% 할인)입니다.

여러 쿠팡 계정을 한 스톡루프 에서 관리할 수 있나요?

가능합니다. 헤더 상단 샵 선택 드롭다운에서 샵을 전환할 수 있으며, 각 샵의 API 키와 데이터는 완전히 격리됩니다.

API 키를 잘못 입력했어요. 어떻게 변경하나요?

⚙️ 설정 → 쿠팡 샵 관리 → 해당 샵 → 키 변경 버튼으로 3종(Vendor ID, Access Key, Secret Key)을 다시 입력하시면 됩니다.

판매자로켓 동기화는 얼마나 걸리나요?

첫 동기화는 약 2분, 이후 증분 동기화는 약 1분 소요됩니다. 진행 중 polling 상태가 표시됩니다.

입고 엑셀 다운로드 후 Wing 이 거부합니다.

Wing 양식은 다운로드 시점마다 갱신됩니다. 반드시 Wing 에서 새 양식을 다운받아 스톡루프 에 업로드한 후, 스톡루프 가 반환한 엑셀을 Wing 에 업로드해야 합니다.

유통기한이 없는 상품인데 입력하라고 합니다.

vendor 카탈로그에 유통기한 관리 플래그가 켜져 있을 가능성이 높습니다. 모달의 default 자동 제안값(입고일 + 유통기간) 그대로 사용하시거나, 직전 입고값 회색 hint 를 클릭해 자동 채움 후 진행 가능합니다.

직전 입고했던 소비기한이 표시됩니다.

v3 기능 — 같은 SKU 를 이전에 입고하실 때 입력하셨던 소비기한이 회색으로 표시됩니다. 클릭 한 번으로 자동 채움됩니다.

마진 계산기 결과가 실제 정산과 다릅니다.

마진 계산기는 SKU별 쿠팡 카테고리 자동 수수료율(직접 지정 가능)과 로켓 입출고·배송비를 반영합니다. 90일 실 정산 데이터(revenue-history) 연동이 제공되어 건당 실제 정산액 기준으로 확인할 수 있습니다.

데이터 보관 기간은 어떻게 되나요?

회원 탈퇴 후 30일까지 보관 후 삭제됩니다. 감사 이력(로그인/API 호출 기록 등)은 1년간 보존됩니다.

탈퇴는 어떻게 하나요?

설정 → 계정 → "탈퇴" 메뉴에서 가능합니다(향후 추가). 현재 이용 중지를 원하시면 [email protected] 으로 문의 부탁드립니다.

문의는 어디로 하나요?

이메일 [email protected] 으로 문의 부탁드립니다. 운영 시간 외에도 24시간 이내 회신드립니다.

중복 키 등록 시 "다른 계정에서 사용 중" 메시지가 뜹니다.

같은 Wing API Key 또는 Vendor ID 는 한 스톡루프 계정에서만 등록 가능합니다. 본인 다른 샵에서 사용 중이면 "본인 계정의 다른 샵에서 사용 중", 타 사용자가 등록했으면 "다른 계정에서 사용 중"으로 안내됩니다.

쿠팡 Wing API 키 발급 방법

API 키 발급

스톡루프에 API 키 입력

🔌 스톡루프 — API 키 입력 필드

API 키 설정 완료!

💡자주 묻는 질문

📚 스톡루프 사용 가이드

🚀 첫 시작

🔄 판매자로켓 동기화

📦 입고하기

💰 마진 계산기

🏷️ 바코드 / 라벨

❓ 자주 묻는 질문 (FAQ)