이용 가이드
COUPANG WING · OPEN API

쿠팡 Wing API 키 발급 방법

25도씨 쿠팡도우미를 사용하려면 쿠팡 Wing에서 API 키를 발급받아야 합니다.
wing.coupang.com에 로그인 후 아래 단계를 따라하시면 5분 이내에 완료됩니다.

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

API 키 발급

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

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

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

Wing 우측 상단 메뉴 → 추가판매정보

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

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

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

API Key 발급 받기 버튼

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

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

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

키의 사용 목적 선택 — OPEN API

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

⚠️ "플레이오토 웹 솔루션"이 아닌 반드시 "OPEN API"를 선택해야 합니다.
4
약관 두 가지 모두 체크 → "약관 동의 및 Key 발급받기" 클릭

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

  • ✅ API 이용 약관에 동의합니다.
  • ✅ 카테고리 자동 매칭 서비스 이용에 동의합니다.
약관 동의 및 Key 발급받기

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

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

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

📋 아래 내용을 그대로 복사해서 붙여넣으세요
업체명 25coupang
URL https://25coupang.shop
IP 주소 54.180.169.15
업체명/URL/IP 입력 화면

▲ 자체개발(직접입력) 선택 후 위 값 입력 → 확인

6
🚨 필수! — 판매자 로켓 상품 생성 API 이용 및 검수 기준 동의 클릭

키 발급 완료 후 테이블 우측에 나타나는 아래 버튼을 반드시 클릭해야 합니다.
이 동의 없이는 판매자 로켓 상품 관련 API 기능이 제한됩니다.

판매자 로켓 상품 생성 API 이용 및 검수 기준 동의 버튼

▲ 빨간 원 안의 버튼 클릭

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

✅ 이미 동의한 경우 버튼이 "이미 동의 하셨습니다."로 표시됩니다. 다시 클릭할 필요 없습니다.
⏱️ 수정사항 반영까지는 최대 30분이 걸릴 수 있습니다.
🔄 유효기간 이후 키를 재발급해주세요. 재발급 시 시크릿키(Secret Key)가 변경됩니다. 변경 후 25도씨 쿠팡도우미 설정에서도 새 키로 업데이트해 주세요.
🎉 모든 절차가 완료됐습니다! 이제 발급된 업체코드 · Access Key · Secret Key를 STEP 2에서 25도씨 쿠팡도우미에 입력하면 됩니다.
💡 이미 쿠팡 Wing에서 다른 솔루션(예: 플레이오토 등)으로 API 키를 발급받은 경우입니다.
새로 발급하지 않고 연동 정보 수정으로 25도씨 쿠팡도우미를 추가합니다.
⚠️ 중요: IP 주소 입력 시 기존 솔루션 IP와 우리 IP를 쉼표(,)로 구분해 함께 입력해야 합니다.
기존 IP를 지우고 우리 IP만 입력하면 기존 솔루션이 연동 끊깁니다!
0
⚡ 시작 전 준비 — 기존 솔루션의 쿠팡 연동 IP 확인

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

📌 기존 솔루션(예: 플레이오토, 사방넷 등) 고객센터에 문의하여
"쿠팡 Wing 연동 IP가 무엇인가요?"라고 물어보세요.
확인 후 메모해 두었다가 Step 3에서 함께 입력합니다.
💡 입력 형식 예시 (쉼표 뒤 공백 포함):
기존솔루션IP, 54.180.169.15
예) 173.38.7.190, 54.180.169.15
1
우측 상단 이름 클릭 → 추가판매정보 선택

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

Wing 우측 상단 메뉴 → 추가판매정보

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

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

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

연동 정보 수정 버튼

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

⚠️ 키를 재발급하면 기존 연동된 서비스(플레이오토 등)의 API 연결이 끊길 수 있습니다.
반드시 "수정" 버튼을 사용하세요.
3
업체 입력 방식: 자체개발(직접입력) 선택 → 아래 값 입력

"OPEN API 키 수정" 팝업이 열리면 "자체개발(직접입력)"을 선택하고
아래 값을 그대로 복사해서 붙여넣은 후 "확인"을 클릭합니다.

📋 아래 내용을 그대로 복사해서 붙여넣으세요
업체명 25coupang
URL https://25coupang.shop
IP 주소
54.180.169.15
⚠️ Wing 입력 칸에는 기존 솔루션 IP와 우리 IP를 쉼표(,)로 구분해 함께 입력하세요.
입력 형식: 기존솔루션IP, 54.180.169.15
예) 173.38.7.190, 54.180.169.15
OPEN API 키 수정 팝업

▲ 자체개발(직접입력) 선택 → 위 값 입력 → 확인

✅ 확인 버튼을 누르면 연동 정보가 업데이트됩니다. 이후 STEP 5에서 업체코드 · Access Key · Secret Key를 도우미에 입력하면 완료입니다.
2

25도씨 쿠팡도우미에 API 키 입력

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

1
설정 화면에서 API 키 입력

25도씨 쿠팡도우미 앱 또는 웹에서 ⚙ 설정 화면을 열고 API 키를 입력합니다.

🔌 25도씨 쿠팡도우미 — API 키 입력 필드

Vendor ID → Wing 업체코드 (예: A000XXXXX) Wing 업체코드
Access Key → 오픈 API 관리에서 발급된 Access Key Access Key
Secret Key → 오픈 API 관리에서 발급된 Secret Key Secret Key
2
연결 테스트 및 저장

세 가지 키를 모두 입력한 후 "연결 테스트" 버튼을 클릭합니다.
✅ 연결 성공! 메시지가 표시되면 "저장하기"를 눌러 완료합니다.

🎉 연결 성공 후 재고 동기화를 클릭하면 쿠팡 Wing의 상품 목록과 판매 데이터를 바로 불러올 수 있습니다!
💡 연결 실패 시 체크 사항:
1. Vendor ID가 A000으로 시작하는지 확인
2. Access Key / Secret Key에 공백이 없는지 확인
3. 쿠팡 Wing에서 API 키가 활성화 상태인지 확인
🎊

API 키 설정 완료!

이제 25도씨 쿠팡도우미로 재고 현황, 판매 데이터, 엑셀 리포트를 한 번에 관리할 수 있습니다.

← 앱으로 돌아가기

💡자주 묻는 질문

Q. 가입 직후 우측 상단에 빨간 알림("열쇠 아이콘 클릭")이 떠요

사장님 브라우저에 설치된 비밀번호 관리자(Bitwarden, 1Password, Chrome 등)가 cphelper 비밀번호 저장 여부를 묻는 알림입니다. 25도씨와 무관하며 X로 닫으시거나 저장 선택하시면 됩니다.

📚 25도씨 쿠팡 도우미 사용 가이드

회원가입부터 입고 엑셀 자동 채움까지 — 단계별로 안내해드립니다

🚀 첫 시작

회원가입 → 로그인 → 샵 등록까지 3분이면 완료됩니다.
1
회원가입
25coupang.shop 메인 화면에서 "회원가입" 클릭 → 이메일/비밀번호 입력. 가입 직후 관리자 자동 승인됩니다.
2
로그인
가입한 이메일/비밀번호로 로그인. 초기 진입 페이지는 /dashboard 셀러 대시보드.
3
Wing API 키 발급
위 페이지(🔑 Wing API 키 발급)의 CASE 1 또는 CASE 2 안내에 따라 쿠팡 Wing 에서 Vendor ID / Access Key / Secret Key 3종 발급.
4
샵 등록
설정(⚙️) → 샵 관리 → "+ 신규 샵" 클릭 → 3종 키 입력 → 저장. Wing 측 IP 등록 반영까지 최대 30분 소요.
💡 팁 — 여러 쿠팡 계정을 한 cphelper 에서 관리하시려면 "+ 신규 샵" 으로 추가 등록 가능합니다. 헤더 "메인샵 ▼" 드롭다운에서 샵 전환.
⚠️ 주의 — 동일 Access Key/Vendor ID 는 본인 다른 샵 또는 다른 계정에서 사용 중이면 등록 차단됩니다.
대시보드로 이동 →

🔄 재고 동기화

쿠팡 RG 데이터를 가져와 권장 입고 수량을 자동 계산합니다.
1
재고 동기화 (기본)
재고현황(/inventory) 우측 상단 "🔄 재고 동기화" → 약 1~2분 polling. 완료 시 SKU 목록 + 재고/판매 데이터 표시.
2
RG 동기화 (v4)
재고현황 툴바 "🔄 RG 동기화 (v4)" — rg/orders 90일 + 환불 + 재고 누적해 권장 수량 정확 계산. 약 1~2분.
3
권장 입고 화면 확인
상단 4 카드(FAST / MEDIUM / SLOW / STAGNANT) + 행별 분류 배지 + 권장수량 표시. 카드 클릭 시 표 필터링.
💡 팁 — 설정 → "🎯 권장 입고 임계값" 카드에서 분류 기준과 재입고 주기를 조정할 수 있습니다.
재고현황으로 이동 →

📦 입고하기 (Wing 엑셀)

Wing 39컬럼 양식을 cphelper 가 자동 채워 드립니다. 8단계 흐름.
1
권장수량 적용
재고현황에서 "⚡ 권장수량 전체 적용" 또는 개별 SKU 에 입고수량 입력.
2
"📦 입고하기 (쿠팡 Wing)" 클릭
툴바의 v2 버튼 클릭 → 3-step 모달 열림.
3
Wing 양식 다운로드
모달 Step 1 "Wing 입고 페이지 새 탭" → 쿠팡 Wing 의 로켓그로스 입고 페이지에서 "엑셀로 업로드하기" → 양식 다운.
4
cphelper 에 양식 업로드
다운받은 .xlsx 를 모달 Step 1 의 파일 input 에 업로드. "다음 →" 클릭.
5
유통기한 입력 (필요한 SKU만)
Step 2 — 유통기한 정보가 필요한 SKU 만 모달에 표시. default 자동 제안값(입고일 + 유통기간) 그대로 사용 또는 수정.
6
직전 입고값 hint (v3)
같은 SKU 를 이전에 입고하실 때 입력하셨던 소비기한이 회색으로 표시됩니다. 클릭 한 번으로 자동 채움.
7
cphelper 엑셀 다운로드
Step 3 "✅ 엑셀 다운로드" → cphelper 가 V(입고수량) + X/Y/Z/AA(유통기한) + AK/AL/AM(Req 플래그) 만 덮어쓴 .xlsx 반환.
8
Wing 에 다시 업로드
Wing 입고 페이지에서 "엑셀로 업로드" → cphelper 가 반환한 엑셀 업로드 → Step 2 입고 정보 → Step 3 배송 구성 → 완료.
⚠️ 주의 — Wing 양식은 다운로드 시점마다 갱신됩니다. 반드시 매번 새로 다운로드 받아서 cphelper 에 업로드한 후, cphelper 가 반환한 엑셀을 Wing 에 업로드해야 합니다.
💡 팁 — cphelper 가 덮어쓰는 컬럼은 V/X/Y/Z/AA/AK/AL/AM 8개뿐입니다. 나머지(매출/카테고리/바코드 등)는 Wing 원본 그대로 보존됩니다.
권장 입고 페이지로 →

💰 마진 계산기

판매가/원가/수수료 입력만으로 실수익을 추정합니다.
1
계산기 진입
사이드바 "💰 마진 계산기" 메뉴 클릭. URL: /margin
2
기본 입력
판매가(원), 원가(원), 평균 수수료율(%) — 로켓그로스 기본 12.5%, 일반 마켓플레이스 10% 권장. 풀필먼트 예상 요금은 SKU 부피/중량 따라 차이.
3
결과 해석
결과 카드에 예상 실수익, 마진율, 손익분기 판매량 표시. 마진율이 음수이면 빨간색 경고.
💡 팁 — 마진 계산기는 추정치입니다. 실 정산 데이터(settlement-histories) 통합은 Phase 2에서 제공 예정.
마진 계산기로 →

🏷️ 바코드 / 유니라벨

3가지 모드 — 단일 바코드, 재고 상품 시트, 쿠팡 바코드 PDF → 유니라벨 변환.
① 단일 바코드 코드/타입(CODE128/EAN13 등) 입력 → SVG 미리보기 + PNG/PDF 다운.
② 재고 상품 시트 "📦 재고 불러오기" → SKU 목록 자동 → 일괄 선택 → A4 그리드 시트 PDF.
③ PDF → 유니라벨 쿠팡 바코드 PDF 업로드 → 자동 파싱 → 유니라벨 호환 엑셀 다운.
💡 팁 — 라벨 프린터는 유니라벨 호환 권장 (Brother, Zebra 등). 종이는 100×60mm 또는 50×30mm.
바코드 페이지로 →

❓ 자주 묻는 질문 (FAQ)

사장님들이 자주 문의하시는 12 가지 질문 정리
월 사용료가 얼마인가요?
월 5,900원/샵 — 관리자 승인 후 활성화됩니다. 여러 쿠팡 계정을 같은 cphelper 에서 관리하시려면 샵당 5,900원이 일률 적용됩니다.
여러 쿠팡 계정을 한 cphelper 에서 관리할 수 있나요?
가능합니다. 헤더 상단 "메인샵 ▼" 드롭다운에서 샵 전환이 가능하며, 각 샵의 API 키와 데이터는 완전히 격리됩니다.
API 키를 잘못 입력했어요. 어떻게 변경하나요?
설정 → 샵 관리 → 해당 샵 → "키 갱신" 버튼으로 3종(Vendor ID, Access Key, Secret Key)을 다시 입력하시면 됩니다.
RG 동기화는 얼마나 걸리나요?
첫 동기화는 약 2분, 이후 증분 동기화는 약 1분 소요됩니다. 진행 중 polling 상태가 표시됩니다.
입고 엑셀 다운로드 후 Wing 이 거부합니다.
Wing 양식은 다운로드 시점마다 갱신됩니다. 반드시 Wing 에서 새 양식을 다운받아 cphelper 에 업로드한 후, cphelper 가 반환한 엑셀을 Wing 에 업로드해야 합니다.
유통기한이 없는 상품인데 입력하라고 합니다.
vendor 카탈로그에 유통기한 관리 플래그가 켜져 있을 가능성이 높습니다. 모달의 default 자동 제안값(입고일 + 유통기간) 그대로 사용하시거나, 직전 입고값 회색 hint 를 클릭해 자동 채움 후 진행 가능합니다.
직전 입고했던 소비기한이 표시됩니다.
v3 기능 — 같은 SKU 를 이전에 입고하실 때 입력하셨던 소비기한이 회색으로 표시됩니다. 클릭 한 번으로 자동 채움됩니다.
마진 계산기 결과가 실제 정산과 다릅니다.
현재 마진 계산기는 sale_price 와 평균 수수료율 추정값을 사용합니다. 실 정산 데이터(settlement-histories) 통합은 Phase 2 에서 제공될 예정입니다.
데이터 보관 기간은 어떻게 되나요?
회원 탈퇴 후 30일까지 보관 후 삭제됩니다. 감사 이력(로그인/API 호출 기록 등)은 1년간 보존됩니다.
탈퇴는 어떻게 하나요?
설정 → 계정 → "탈퇴" 메뉴에서 가능합니다(향후 추가). 현재 이용 중지를 원하시면 [email protected] 으로 문의 부탁드립니다.
문의는 어디로 하나요?
이메일 [email protected] 으로 문의 부탁드립니다. 운영 시간 외에도 24시간 이내 회신드립니다.
중복 키 등록 시 "다른 계정에서 사용 중" 메시지가 뜹니다.
같은 Wing API Key 또는 Vendor ID 는 한 cphelper 계정에서만 등록 가능합니다. 본인 다른 샵에서 사용 중이면 "본인 계정의 다른 샵에서 사용 중", 타 사용자가 등록했으면 "다른 계정에서 사용 중"으로 안내됩니다.