# 쿠팡 마켓 계정 연동

> 💡 이 문서를 마치면 쿠팡 윙에서 출고지·반품지와 OPEN API 키를 준비하고, 쿠팡 판매자 계정을 Spresso에 연결할 수 있습니다. (⏱️ 약 15분)
>
> 📍 메뉴 위치: 쿠팡 윙 **판매자정보** → Spresso **마켓 관리 > 마켓 계정 관리**\
> ✅ 미리 준비: 입점 승인이 끝난 쿠팡 판매자 계정([쿠팡 가입](signup-coupang.md)), Spresso 계정 팝업의 [내 IP](glossary.md)

## 이게 뭔가요?

Spresso가 쿠팡에 상품을 올리고 주문을 가져오려면 쿠팡 윙(쿠팡 판매자센터)에서 발급한 OPEN API 키가 필요합니다. 이 키가 Spresso의 [API Key](glossary.md)입니다. 순서는 셋입니다.

1. 쿠팡 윙에 [출고지·반품지](glossary.md)를 등록합니다. Spresso 마켓 정책에서 이 주소를 고르므로 먼저 해 둡니다.
2. 쿠팡 윙에서 OPEN API 키를 발급받습니다.
3. Spresso에 키를 넣고 테스트한 뒤 저장합니다.

### 어느 쪽인가요?

출고지 주소는 판매 방식([해외 구매대행·위탁 판매·사입 판매](glossary.md))에 따라 다릅니다. 반품지는 모두 실제 상품을 받을 수 있는 국내 사무실 주소입니다.

| 판매 방식 | 출고지 | 반품지 |
| --- | --- | --- |
| 해외 구매대행 | 국가 구분 ‘해외’, 해외 주소(쓰는 [배송대행지](glossary.md) 주소) | 국내 사무실 주소 |
| 국내 위탁 판매·사입 판매 | 국가 구분 ‘국내’, 사무실 또는 실제 출고지 주소 | 국내 사무실 주소 |

## 🚚 쿠팡 출고지/반품지 등록하기

1. **[쿠팡 윙](https://wing.coupang.com/)**에 접속해 로그인합니다.
2. **판매자정보 > 주소록/배송정보 관리 > 새주소지 등록**을 선택합니다.

![쿠팡 윙의 새주소지 등록 메뉴](../img/connect-coupang-01.png)

3. 출고지를 등록합니다. 국가 구분과 주소는 위 "어느 쪽인가요?" 표대로 넣습니다.
   - 제주/도서산간 배송여부는 ‘가능’으로 선택하고 임의의 택배사와 금액을 입력합니다.
4. 반품지를 등록합니다. 실제 상품을 받을 수 있는 국내 사무실 주소를 넣습니다.

   ![쿠팡 윙 해외 출고지·반품지 입력](../img/connect-coupang-02.png)

   > 💡 **아직 쓰는 배송대행지가 없으면 아래 해외 주소를 임시로 입력합니다.**
   >
   > 국가 : United States\
   > 우편번호 : 07072\
   > 주소 1 : 55 Triangle Blvd Suite B\
   > 주소 2 : Unit A\
   > 전화번호 : 5513785503

   ![쿠팡 윙 국내 출고지·반품지 입력](../img/connect-coupang-03.png)

## 🔑 쿠팡 API Key 발급받기

1. **[쿠팡 윙](https://wing.coupang.com/)**에 접속해 로그인합니다.
2. **판매자정보 > 추가판매정보 > API Key 발급 받기**를 선택합니다.

![쿠팡 윙의 API Key 발급 메뉴](../img/connect-coupang-04.png)

3. 키 사용 목적은 ‘OPEN API’를 선택하고 약관에 동의한 뒤 **[Key 발급받기]**를 선택합니다.
   - 이미 발급된 OPEN API 키가 있으면 삭제 또는 수정을 선택해 진행합니다.
   - ⚠️ 다른 프로그램이 그 키를 쓴다면 삭제하지 말고 수정에서 IP만 더합니다(4단계). 키를 지우면 그 키로 연결한 프로그램은 다시 연결해야 합니다.

![쿠팡 윙 OPEN API 키 사용 목적 선택](../img/connect-coupang-05.png)

4. 발급 화면에서 업체 입력 방식은 ‘자체개발’을 선택하고 아래 내용을 입력한 뒤 **[확인]**을 선택합니다.
   - 업체명: Spresso
   - URL: https://console.spresso.kr
   - IP 주소: Spresso 전용 서버 IP. Spresso 사이드바 맨 위 계정 영역을 선택하면 열리는 계정 팝업의 **내 IP** 옆 복사 아이콘으로 복사합니다([화면 둘러보기](app-basics.md)).
     - 다른 프로그램도 함께 쓰면 IP를 쉼표(,)로 구분해 더 넣을 수 있습니다.

![쿠팡 윙 OPEN API 키 발급 정보 칸](../img/connect-coupang-06.png)

5. OPEN API 키가 발급되면 업체코드, Access Key, Secret Key를 복사해 메모합니다.

![쿠팡 윙의 업체코드·Access·Secret Key](../img/connect-coupang-07.png)

## Spresso에 쿠팡 마켓 계정 추가하기

1. [Spresso](https://console.spresso.kr/)에 로그인한 뒤 **마켓 관리 > 마켓 계정 관리**로 이동합니다.
2. **쿠팡** 탭을 선택하고 **[마켓 계정 추가]**를 선택합니다.

![마켓 계정 관리의 쿠팡 탭](../img/connect-coupang-08.png)

3. **마켓 계정 추가** 칸에 아래 항목을 입력합니다.

   | 칸 | 넣을 값 |
   | --- | --- |
   | 아이디 | 쿠팡 아이디 |
   | 업체 코드 | OPEN API 키 발급 화면의 업체코드 |
   | 쿠팡 API Key | OPEN API 키 발급 화면의 Access Key |
   | Secret Key | OPEN API 키 발급 화면의 Secret Key |

4. **[API Key 테스트]**를 선택합니다.
   - 안 되면: 아래 "자주 보는 메시지"를 봅니다. 키를 막 발급받았다면 아래 💡처럼 시간이 지난 뒤 다시 테스트합니다.
5. "테스트 성공"이 나오면 (선택) 옵션을 정합니다.
   - 최대 등록 상품 개수: 이 계정에 등록할 최대 상품 수. 비워 두면 목록에 "제한 없음"으로 나옵니다.
   - 자주 사용하는 택배사: **주문 조회**에서 송장 택배사를 고를 때 여기서 고른 택배사만 나옵니다.
6. **[변경사항 저장]**을 선택합니다.

![쿠팡 마켓 계정 추가 칸](../img/connect-coupang-09.png)

> 💡 쿠팡 API Key를 새로 발급받거나 수정하면 쿠팡이 새 키를 확인하는 동안 최소 15분에서 최대 3시간까지 API Key 테스트가 실패할 수 있습니다. 시간이 지난 뒤 다시 테스트합니다.

## 결과 확인

"변경사항을 저장하였습니다."가 나오고 쿠팡 탭 계정 목록에 쿠팡 아이디가 생기고 연동 상태가 "연결"(초록)이면 끝입니다.

## 자주 보는 메시지

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 계정 확인에 실패했습니다. | 쿠팡이 사유를 알려 주지 않고 거절했습니다. 쿠팡 윙 OPEN API 키의 IP 주소에 **내 IP**를 넣었는지, 키를 빠짐없이 복사했는지 확인합니다. 키를 막 발급받거나 고쳤으면 시간이 지난 뒤 다시 테스트합니다. |
| Specified key is not registered. 가 들어간 문구, 또는 쿠팡에 등록되지 않은 API 키입니다. 쿠팡 WING에서 API 키를 확인한 뒤 다시 연동해주세요. | 쿠팡이 이 Access Key를 모릅니다. 쿠팡 API Key 칸에 Access Key를 넣었는지 확인합니다. 영어 문구는 테스트 때, 한국어 문구는 연결한 뒤 작업 중에 나옵니다. |
| 현재 IP 주소(…)가 쿠팡 API에서 허용되지 않았습니다. 쿠팡 WING에서 허용 IP를 확인해주세요. | (연결한 뒤 마켓 정책에서 출고지·반품지를 불러올 때) 쿠팡 윙 OPEN API 키의 IP 주소에 **내 IP**가 없습니다. 4단계처럼 IP를 넣습니다. |
| 쿠팡 API 인증이 만료되었습니다. 쿠팡 WING에서 API 키를 재발급한 뒤 다시 연동해주세요. | (연결한 뒤) 쿠팡 키가 만료되었습니다. 쿠팡 윙에서 키를 다시 발급받고 [계정 수정](market-account.md)에서 넣은 뒤 다시 테스트합니다. |

중복 계정·계정 한도처럼 모든 마켓에 같은 문구는 [마켓 계정 관리](market-account.md)에 있습니다.

그래도 안 되면 [고객센터](support.md)에 1:1 문의를 남깁니다. 화면에 나온 문구 그대로, 누른 버튼, 시각, 쿠팡 윙에서 키를 발급하거나 고친 시각을 적습니다. Access Key·Secret Key는 적지 않습니다.

## 쿠팡에서 지금 되는 것

- **상품**: 등록·수정·품절·삭제가 됩니다.
- **주문**: 주문 가져오기·발주 처리·송장 전송이 됩니다. 송장은 마켓 상태가 배송준비·배송중인 주문만 보냅니다([주문 조회](order-search.md)).
- **문의**: 고객 문의·고객센터 문의를 가져와 답변합니다. 쿠팡 고객센터가 넘긴 문의는 **[확인처리]**만 합니다([문의 조회](cs.md)).

> 💡 연결한 쿠팡 계정을 지우려면 이 계정으로 등록한 상품을 모두 삭제하고 이 계정을 쓰는 마켓 정책 연결도 풀어야 합니다. 그다음 **[계정 삭제]**를 선택합니다([마켓 계정 관리](market-account.md)).

## 다음 단계

- 다른 마켓도 연결한다면 [마켓 계정 연동하기](start-market.md)
- **STEP 4** [기본 정책 만들기](start-policy.md)

## 관련 문서

- [마켓 계정 관리](market-account.md) — 테스트 결과·계정 수정·삭제
- [마켓 정책](policy-market.md) — 등록한 출고지·반품지 고르기