# 마켓 계정 연동하기

> 💡 이 문서를 마치면 상품을 올릴 마켓의 판매자 계정을 Spresso에 연결할 수 있습니다. (⏱️ 마켓마다 약 15~20분)
>
> 📍 메뉴 위치: **마켓 관리 > 마켓 계정 관리**\
> ✅ 미리 준비: 마켓 판매자 계정([마켓 계정 만들기](market-signup.md))

## 이게 뭔가요?

Spresso가 마켓에 상품을 등록하고 주문을 가져오려면 마켓의 판매자 계정을 Spresso와 연결해야 합니다([마켓 계정 연동](glossary.md)). 마켓 판매자센터에서 [API Key](glossary.md) 같은 연결 정보를 받아 Spresso에 넣고 연결 테스트에 성공하면 저장합니다. 여러 마켓에 팔려면 마켓마다 한 번씩 연결합니다.

> 💡 국내 마켓 대부분은 판매자센터에 Spresso 전용 서버 IP를 미리 등록해야 연결됩니다([IP 사전등록](glossary.md)). 이 IP는 계정 팝업의 **내 IP**에서 복사합니다. 계정 팝업은 왼쪽 사이드바 맨 위에서 **아이디님**이 보이는 계정 영역을 선택하면 열립니다([화면 둘러보기 (사이드바·상단 탭·계정 팝업·이용 제한)](app-basics.md)).

## 어느 마켓인가요?

마켓마다 판매자센터에서 준비할 것과 Spresso에서 누르는 테스트 버튼이 다릅니다. 연결할 마켓의 문서를 열어 처음부터 끝까지 따라 합니다. 마켓별 문서의 마지막 절이 아래 "Spresso에 넣기"와 같은 순서입니다.

| 마켓 | 판매자센터에서 준비할 것 | 내 IP 등록 | 테스트 버튼 |
| --- | --- | --- | --- |
| [쿠팡](connect-coupang.md) | 출고지·반품지, OPEN API 키 | 함 | **[API Key 테스트]** |
| [스마트스토어](connect-smartstore.md) | 출고지·반품지, 애플리케이션 ID | 함 | **[API Key 테스트]** |
| [11번가](connect-11st.md) | 출고지·반품지, 발송예정일 템플릿, API Key | 함 | **[API Key 테스트]** |
| [G마켓·옥션(ESM)](connect-esm.md) | 출고지·반품지, 배송비. 연결에는 ESM 아이디·비밀번호를 씁니다 | 안 함 | **[로그인 테스트]** |
| [롯데온](connect-lotteon.md) | 출고지·회수지·배송비 정책, OpenAPI Key | 함 | **[API Key 테스트]** |
| [eBay](connect-ebay.md) | 비즈니스 정책(결제·반품·배송), eBay Developers 키([eBay API 키 발급](ebay-key.md)) | 안 함 | **[인증 URL 생성]** → **[API Key 테스트]** |

> 💡 **마켓 관리 > 마켓 계정 관리**에 보이는 마켓 탭은 가입할 때 고른 판매 형태에 따라 다릅니다. 국내 판매는 쿠팡·스마트스토어·11번가·G마켓·옥션·롯데온, 해외 판매는 eBay 탭이 나옵니다. 연결할 마켓 탭이 없으면 [결제 관리](payment.md)에서 플랜의 마켓 범위를 바꿉니다.

## Spresso에 넣기 (모든 마켓 공통)

판매자센터에서 연결 정보를 받았으면 Spresso에서 아래처럼 넣습니다. 마켓별 문서를 끝까지 따라 했다면 이 절은 이미 마쳤으니 "결과 확인"으로 넘어갑니다.

1. Spresso 왼쪽 사이드바에서 **마켓 관리 > 마켓 계정 관리**로 이동합니다.
2. 위쪽 마켓 탭에서 연결할 마켓을 선택합니다.
   - 탭이 없으면 위 💡처럼 플랜의 마켓 범위를 확인합니다.
3. 오른쪽 아래 **[마켓 계정 추가]**를 선택합니다. 아래에 **마켓 계정 추가** 칸이 열립니다.

   ![마켓 계정 관리의 마켓 탭과 추가 버튼](../img/market-account-01.png)

4. 마켓 아이디와 연결 정보를 입력합니다.
   - 칸 옆 **발급가이드**를 선택하면 연결 정보를 받는 방법이 새 창으로 열립니다.
5. 테스트 버튼을 선택합니다. 대부분은 **[API Key 테스트]**, G마켓·옥션은 **[로그인 테스트]**입니다. eBay는 **[인증 URL 생성]**으로 eBay에 로그인한 뒤 완료 화면 주소를 **인증 URL**에 넣고 **[API Key 테스트]**를 선택합니다.
   - 칸 아래에 "테스트 성공"이 나오면 다음으로 넘어갑니다.
   - 안 되면: 칸 아래에 "테스트 실패"가, 화면 위에 마켓이 알려 준 이유가 나옵니다. 아래 "자주 보는 메시지"를 봅니다.
   - G마켓·옥션에서 "2차 인증이 필요합니다."가 나오면 [ESM (G마켓/옥션) 마켓 계정 연동](connect-esm.md)의 "2차 인증이 필요할 때"를 따릅니다.
6. 나머지 칸을 정합니다.
   - **자주 사용하는 택배사**(국내 마켓): 송장을 보낼 때 쓰는 택배사를 고릅니다. **STEP 8** [첫 주문 처리하기](start-order.md)에서 송장을 넣을 때 여기서 고른 택배사만 나옵니다.
   - **최대 등록 상품 개수**(선택): 비워 두면 "제한 없음"입니다.
7. 칸 오른쪽 위 **[변경사항 저장]**을 선택합니다. 테스트에 성공해야 이 버튼이 눌립니다.

   ![마켓 계정 추가 칸의 입력 항목](../img/market-account-02.png)

## 결과 확인

"변경사항을 저장하였습니다."가 나오고 마켓 탭의 계정 목록에 연결한 아이디가 보이며 **연동 상태**가 "연결"(초록)이면 끝입니다. 다른 마켓도 연결하려면 그 마켓 문서로 돌아가 같은 순서를 반복합니다.

## 자주 보는 메시지

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 테스트 실패 | 마켓이 연결을 거절했습니다. 함께 나온 이유를 보고 연결 정보를 고친 뒤 다시 테스트합니다. 쿠팡·스마트스토어·11번가·롯데온은 판매자센터에 **내 IP**를 등록했는지 확인합니다. |
| 계정 확인에 실패했습니다. | 마켓이 이유를 알려 주지 않고 거절했습니다. 연결 정보를 빠짐없이 복사했는지, (G마켓·옥션을 뺀 마켓은) 판매자센터에 **내 IP**를 등록했는지 확인하고 다시 테스트합니다. |
| API 연결 상태를 확인해주세요 | 연결 테스트에 성공하지 않은 채 저장했습니다. 테스트에 성공한 뒤 저장합니다. |
| 계정 등록 갯수를 초과했습니다. 서비스를 업그레이드해주세요. | 플랜의 "마켓 계정" 한도(모든 마켓 합계)를 넘었습니다. [결제 관리](payment.md)에서 부가서비스를 늘립니다. |
| 중복된 계정이 존재합니다. | 같은 마켓에 같은 계정(아이디나 API Key)이 이미 연결되어 있습니다. |

마켓별 메시지와 계정 수정·삭제는 [마켓 계정 관리](market-account.md), 그 밖의 문구는 [자주 보는 오류 메시지](trouble-errors.md)를 봅니다.

그래도 안 되면 [고객센터](support.md)에 1:1 문의를 남깁니다. 마켓 이름, 누른 테스트 버튼, 화면에 나온 문구 그대로, 시각을 적습니다. API Key·비밀번호는 적지 않습니다.

## 다음 단계

- **STEP 4** [기본 정책 만들기](start-policy.md)

## 관련 문서

- [마켓 계정 관리](market-account.md) — 계정 고치기·다시 연결·삭제
- [마켓 계정 만들기](market-signup.md) — 아직 판매자 계정이 없을 때
- [결제 관리](payment.md) — 마켓 범위·마켓 계정 한도