쿠팡 API 키 발급 가이드

쿠팡 윙(WING)에서 별도 신청이나 심사 없이 바로 발급합니다.

약 5분이면 끝납니다. 이후에는 180일마다 재발급만 하면 됩니다.

준비물: 쿠팡 윙(WING) 로그인 정보. 사업자 인증이 완료된 판매자 계정이어야 발급 버튼이 활성화됩니다.

쿠팡 주문 유형별 지원 범위

  • 일반 주문 (판매자배송)완전 지원

    매출, 취소, 정산이 주문 건별로 정확히 반영됩니다.

  • 로켓그로스 (쿠팡 배송)일부 제한

    쿠팡이 로켓그로스의 쿠폰, 취소, 정산과 건별 내역을 API로 제공하지 않습니다. 쿠팡 WING에서도 집계로만 보여, 매출은 할인 전 정가로 실제보다 높게, 취소는 미반영으로 표시되고, 일자별 건별 대조는 되지 않습니다.

  1. 발급 메뉴 열기
  2. 연동 정보 입력
  3. 키 3개 복사
  4. 대시보드 연결
1

WING에서 OPEN API 키 발급 메뉴 열기

쿠팡 WING 화면
  1. 쿠팡 윙 로그인 후 우측 상단 판매자(업체명) 아이디를 클릭합니다.
  2. 판매자정보 → 추가판매정보로 이동합니다.
  3. 하단 OPEN API 키 발급에서 [발급] 누르고, 이용 목적을 OPEN API로 지정한 뒤 약관에 동의합니다.

이렇게 되면 성공: 약관 동의 후 연동 정보를 입력하는 창이 열리면 성공입니다.

2

연동 정보 입력 (3칸)

쿠팡 WING 화면

업체 입력 방식에서 자체개발(직접입력)을 선택한 뒤, 세 칸에 아래 값을 복사해 넣으세요.

업체명HedgieLabs
URLhedgielabs.com
IP 주소43.201.181.155
  • IP는 붙여넣은 뒤 [추가] 버튼을 눌러야 등록됩니다. 입력칸 위에 43.201.181.155 × 모양의 칩이 생겼는지 확인하세요.
  • 세 칸이 모두 채워져야 [확인] 버튼이 활성화됩니다.
  • 창 하단의 내 IP 주소를 확인해주세요 안내는 무시하세요. 내 컴퓨터 IP가 아니라 위의 헤지랩스 고정 IP가 맞습니다.

이미 키를 발급받았다면 키 표 아래 연동 정보[수정] 누르면 같은 창이 열립니다. 키를 다시 발급할 필요 없이 IP만 추가하면 됩니다.

샵링커 같은 다른 셀러툴을 연동업체 선택 방식으로 쓰고 있다면, 방식을 바꾸는 순간 기존 툴의 연동이 끊길 수 있습니다. 계속 쓸 예정이면 쿠팡 판매자콜센터(1600-9879)에 병행 방법을 먼저 확인하세요.

이렇게 되면 성공: IP 칩(43.201.181.155 ×)이 생기고 [확인] 버튼이 활성화되면 성공입니다.

3

키 3개 복사

쿠팡 WING 화면

발급이 끝나면 같은 화면의 표에 업체코드(Vendor ID), Access Key, Secret Key가 함께 표시됩니다. 세 값을 모두 복사하세요.

  • 업체코드는 A로 시작하는 9자리입니다(예: A00012345). 사업자등록번호와 다릅니다.
  • 키는 다른 사람에게 노출되지 않도록 안전한 곳에 보관하세요.
키 유효기간은 180일입니다. 만료 14일 전부터 [재발급] 버튼이 활성화되고, 같은 시점과 7일 전에 쿠팡이 이메일로 안내합니다. 재발급하면 Secret Key가 새로 생성되므로 대시보드 설정에서 새 키로 다시 연결해 주세요.

이렇게 되면 성공: 업체코드, Access Key, Secret Key를 복사해 두었으면 마지막 단계만 남았습니다.

4

대시보드에 입력

헤지랩스 설정 화면
  1. 설정 페이지로 이동합니다.
  2. 쿠팡 카드에 Access Key, Secret Key, 업체코드를 입력합니다.
  3. [연결] 누르면 키가 암호화되어 저장됩니다.
  4. 1분 안에 첫 동기화가 시작되어 키를 실제로 검증합니다.

이미 연결된 상태에서 키를 재발급했다면, 쿠팡 카드의 [API 키 재입력]으로 새 키를 저장하면 됩니다.

이렇게 되면 성공: 쿠팡 카드에 연결됨이 표시됩니다. 키나 IP에 문제가 있으면 카드에 원인이 한국어로 표시됩니다.

연결 후 데이터가 차오르는 순서

  • 최근 주문은 1~2분 안에 대시보드에 표시됩니다.
  • 쿠팡이 열어주는 최근 31일치를 자동으로 불러옵니다. 쿠팡 정책상 그 이전 주문은 가져올 수 없습니다.
  • 호출 횟수와 조회 단위 제한은 저희가 자동으로 조절합니다.

막히면 여기를 보세요

Invalid signature 오류가 표시돼요
Access Key나 Secret Key에 오타가 있다는 뜻입니다. WING 키 표에서 두 값을 다시 복사해 붙여넣으세요. 앞뒤 공백과 줄바꿈이 섞이지 않았는지 확인하세요.
IP 관련 오류가 나거나 계속 연결이 안 돼요
2단계의 IP 등록이 안 됐거나 아직 반영 전일 수 있습니다. 최초 발급은 최대 24시간, 이후 정보 수정은 약 30분 걸립니다. 반영을 기다리는 동안 약 1시간마다 최대 이틀간 자동으로 다시 시도하므로, 반영되면 저절로 연결됩니다.
업체코드가 뭔지 모르겠어요
A로 시작하는 9자리이며(예: A00012345) 사업자등록번호와 다릅니다. WING 키 표의 업체코드 칸에 함께 표시됩니다.
연결은 됐는데 주문이 0건이에요
쿠팡은 최근 31일까지만 조회할 수 있어서, 그 기간에 주문이 없다면 0건이 정상입니다.
그래도 안 돼요
드물게 쿠팡 보안망이 호출 IP를 차단하는 경우가 있습니다. 고객센터로 알려주시면 저희가 원인을 확인해 드립니다.

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