쿠팡 API 키 발급 가이드

쿠팡 Open API는 사용 신청 → 승인 → 키 발급 순서로 진행됩니다. 보통 1-2영업일 내 승인됩니다.

1

쿠팡 Wing 접속 + Open API 사용 신청

쿠팡 Wing 로그인 후 Open API Center에서 사용 신청을 먼저 해야 합니다. 심사 후 승인되면 키 발급 메뉴가 활성화됩니다.

쿠팡 Wing 바로가기 → (새 탭에서 열림)개발자 센터 문서 → (새 탭에서 열림)
2

Access Key + Secret Key 발급

  1. 승인 완료 후 Open API Center → API Key 관리 진입
  2. 생성 버튼 클릭
  3. Access Key와 Secret Key를 안전한 곳에 복사
⚠️ Secret Key는 발급 시 1회만 표시됩니다. 안전한 저장소(1Password, Bitwarden 등)에 즉시 보관하세요.
3

Vendor ID (업체 코드) 확인

  1. Wing 상단 우측 계정명 클릭 → 내 정보
  2. 업체 코드(Vendor ID) 항목 복사 (예: A00012345)
  3. API 호출 시 X-Requested-By 헤더에 이 값이 들어갑니다
4

대시보드에 입력

  1. 설정 페이지 진입
  2. 쿠팡 카드에서 Access Key / Secret Key / Vendor ID 입력
  3. 연결 버튼 클릭 → 자동 검증
  4. 성공 시 첫 동기화 자동 실행 (최대 1-2분)

⚠️ 쿠팡 API 한도 안내

  • 조회 가능 기간: 최근 31일까지만, 그 이전 데이터는 별도 백필 불가
  • API 단일 호출 한도 24시간, 자동으로 일자별 split됨 (가입 후 신경 안 써도 됨)
  • 분당 50회 호출 제한, 자동 토큰 버킷으로 제어됨

자주 발생하는 문제

  • "HTTP 401": Access Key 또는 Secret Key 오타. Wing에서 다시 복사 (앞뒤 공백 주의).
  • "HTTP 403": Open API 사용 신청 미승인. Wing에서 신청 상태 확인.
  • "Vendor ID 누락": A로 시작하는 9자리(예: A00012345). 사업자 등록번호와 다름.
  • "주문 조회 0건": API는 주문 발생 시점 이후 데이터만 반환. 신규 가입 직후라면 정상.

🔒 입력한 키는 AES-256-GCM으로 암호화되어 저장됩니다. 화면이나 로그에 노출되지 않습니다.

설정 페이지로 →← 돌아가기