# 마켓 계정 관리

> 💡 이 문서를 마치면 마켓 계정을 추가·수정·삭제하고, 계정마다 등록 개수·택배사 같은 옵션을 정할 수 있습니다. (⏱️ 약 5분, 연결 정보 준비는 마켓별 문서)
>
> 📍 메뉴 위치: **마켓 관리 > 마켓 계정 관리**\
> ✅ 미리 준비: 마켓 판매자 계정과 연결 정보(마켓별 연동 문서), 쿠팡·스마트스토어·11번가·롯데온은 판매자센터에 [내 IP](glossary.md) 등록

## 이게 뭔가요?

Spresso와 연결한 마켓 판매자 계정을 마켓별로 모아 보는 화면입니다. 여기서 계정을 추가·수정·삭제하고 계정마다 쓸 옵션을 정합니다. 마켓 계정을 연결해야 [마켓 정책](glossary.md)을 만들고 상품을 등록하고 주문을 가져올 수 있습니다.

연결할 때는 마켓 판매자센터에서 받은 [API Key](glossary.md) 같은 연결 정보를 넣고 [연결 테스트](glossary.md)에 성공해야 저장됩니다.

### 무엇을 하려고 하나요?

| 하려는 일 | 볼 곳 |
| --- | --- |
| 마켓을 처음 연결 | [마켓 계정 연동하기](start-market.md) → 마켓별 연동 문서(판매자센터 준비부터) |
| 계정을 하나 더 추가 | 아래 "마켓 계정 추가하기" |
| 키·비밀번호를 바꿈, 옵션만 바꿈 | 아래 "계정 수정·다시 연결하기" |
| 계정을 지움 | 아래 "계정 삭제하기" |

## 화면 구성

- **마켓 탭**: 쿠팡 · 스마트스토어 · 11번가 · G마켓 · 옥션 · 롯데온 · eBay. 가입할 때 고른 [마켓 범위](glossary.md)(국내/해외)에 맞는 탭만 나옵니다.
- **계정 목록**: 연동 아이디 / 연동 상태 / 최대 등록 상품 개수 / 연결된 마켓 정책 수 / 동일상품명 제한 / 택배사
  - 연동 상태: "연결"(초록) 또는 "연결안됨"(회색)
  - 최대 등록 상품 개수를 비워 두면 "제한 없음"
  - 택배사: 고른 택배사 수
- **[마켓 계정 추가]**: 목록 오른쪽 아래. 선택하면 아래에 입력 칸이 열립니다.

![마켓 계정 관리의 계정 목록](../img/market-account-01.png)

> ⚠️ 입력하는 중에 마켓 탭을 바꾸면 입력한 값이 확인 없이 사라집니다.

## 마켓마다 다른 것

넣는 칸과 테스트 버튼이 마켓마다 다릅니다. 칸에 넣을 값을 받는 방법은 오른쪽 문서에 있습니다.

| 마켓 | 입력 칸 | 테스트 버튼 | 연결 방법 |
| --- | --- | --- | --- |
| 쿠팡 | 아이디, 업체 코드, 쿠팡 API Key, Secret Key | **[API Key 테스트]** | [쿠팡 마켓 계정 연동](connect-coupang.md) |
| 스마트스토어 | 아이디, 애플리케이션 ID, 애플리케이션 시크릿 | **[API Key 테스트]** | [스마트스토어 마켓 계정 연동](connect-smartstore.md) |
| 11번가 | 아이디, 11번가 API Key | **[API Key 테스트]** | [11번가 마켓 계정 연동](connect-11st.md) |
| G마켓·옥션 | ESM 아이디, ESM 비밀번호 → 테스트 뒤 판매자 아이디 선택 | **[로그인 테스트]** | [ESM (G마켓/옥션) 마켓 계정 연동](connect-esm.md) |
| 롯데온 | 아이디, 롯데온 API Key(롯데ON 스토어센터에서 발급한 OpenAPI Key) | **[API Key 테스트]** | [롯데온 마켓 계정 연동](connect-lotteon.md) |
| eBay | 아이디, App ID, Cert ID, Redirect URI → **[인증 URL 생성]** 뒤 인증 URL([eBay API 키 발급](ebay-key.md)) | **[API Key 테스트]** | [eBay 마켓 계정 연동](connect-ebay.md) |

- 칸 옆 **발급가이드**를 선택하면 연결 정보를 받는 방법이 새 창으로 열립니다.
- 쿠팡·스마트스토어·11번가·롯데온은 판매자센터에 Spresso 전용 서버 IP를 미리 등록해야 테스트에 성공합니다(G마켓·옥션은 ESM 아이디·비밀번호로 연결). IP는 계정 팝업의 **내 IP**에서 복사합니다([화면 둘러보기](app-basics.md)).
- 입력값 앞뒤 공백은 자동으로 지워집니다.
- G마켓과 옥션은 탭마다 따로 연결합니다.

## 마켓 계정 추가하기

1. 마켓 탭을 선택합니다.
2. 목록 오른쪽 아래 **[마켓 계정 추가]**를 선택합니다. 아래에 **마켓 계정 추가** 칸이 열립니다.
3. 마켓별 연결 정보를 입력합니다(위 표).
4. 테스트 버튼을 선택합니다. 칸 아래에 초록 "테스트 성공"이 나오면 다음으로 넘어갑니다. eBay는 테스트 전에 **[인증 URL 생성]**으로 eBay에 로그인하고 완료 화면 주소를 **인증 URL**에 넣습니다([eBay 마켓 계정 연동](connect-ebay.md)).
   - 안 되면: 빨간 "테스트 실패"와 함께 사유가 나옵니다. 아래 "테스트 결과" 표를 봅니다.
   - G마켓·옥션에서 **2차 인증** 줄이 생기면: **[2차 인증 코드 요청]** → 받은 6자리 입력 → **[2차 인증 코드 인증]** → **[로그인 테스트]**를 다시 선택합니다.
5. (선택) 아래 "계정 옵션"을 정합니다.
6. **[변경사항 저장]**을 선택합니다. 테스트에 성공해야 이 버튼이 눌립니다.

![마켓 계정 관리의 계정 추가 칸](../img/market-account-02.png)

"변경사항을 저장하였습니다."가 나오고 칸 제목이 **마켓 계정 수정**으로 바뀌면 끝입니다. 계정 목록에 연결한 아이디가 생기고 연동 상태가 "연결"(초록)으로 보입니다.

### 테스트 결과

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 테스트 성공 | 연결 정보가 맞습니다. 저장 버튼이 켜집니다. |
| 테스트 실패 + 마켓이 알려 준 사유 | 마켓이 연결을 거절했습니다. 사유를 보고 연결 정보와 판매자센터의 IP 등록을 고친 뒤 다시 테스트합니다. 마켓별로 자주 나오는 사유는 마켓별 연동 문서의 "자주 보는 메시지"에 있습니다. |
| 계정 확인에 실패했습니다. | 마켓이 사유를 알려 주지 않고 거절했습니다. 연결 정보를 빠짐없이 복사했는지, 판매자센터에 **내 IP**를 등록했는지 확인하고 다시 테스트합니다. |

> 💡 테스트한 뒤 칸을 고치면 결과가 지워지니 다시 테스트합니다.

## 계정 옵션

| 옵션 | 설명 |
| --- | --- |
| 최대 등록 상품 개수 | 이 계정에 등록할 최대 상품 수. 비우거나 0이면 "제한 없음" |
| 동일상품명 제한 | 체크하면 목록에 Y로 표시 |
| 자주 사용하는 택배사 | 여러 개 선택. **주문 조회**에서 송장 택배사를 고를 때 여기서 고른 택배사만 나옵니다. eBay는 이 칸이 없습니다. |

## 계정 수정·다시 연결하기

마켓에서 키를 새로 발급받았거나 비밀번호를 바꿨을 때, 옵션만 바꿀 때 씁니다.

> ⚠️ 이 계정으로 등록한 상품이 있으면 저장해도 연결 정보는 아래 칸만 바뀝니다. 옵션과 연동 상태는 바뀝니다.
> - 바뀜: 쿠팡 Secret Key, 스마트스토어 애플리케이션 시크릿, G마켓·옥션 ESM 비밀번호, eBay 다시 인증(같은 eBay 계정일 때)
> - 안 바뀜: 스마트스토어 애플리케이션 ID, 11번가 API Key, 롯데온 API Key — "변경사항을 저장하였습니다."가 나와도 예전 값이 그대로 남습니다. 이 값을 바꿔야 하면 [고객센터](support.md) 1:1 문의로 알립니다.

1. 계정 목록에서 계정 줄을 선택합니다. 아래에 **마켓 계정 수정** 칸이 열립니다.
2. 고칠 칸을 고칩니다. 바꿀 수 없는 칸은 잠겨 있습니다.
   - 바꿀 수 없음: 아이디(모든 마켓), 쿠팡 업체 코드·쿠팡 API Key, G마켓·옥션 ESM 아이디·판매자 아이디
   - eBay를 다시 인증하려면 **[인증 URL 생성]**부터 다시 합니다([eBay 마켓 계정 연동](connect-ebay.md)).
3. 연결 정보를 고쳤으면 테스트 버튼을 다시 선택합니다. 옵션만 바꿀 때는 테스트 없이 넘어갑니다.
4. **[변경사항 저장]**을 선택합니다. "변경사항을 저장하였습니다."가 나오면 끝입니다.

![마켓 계정 수정 칸의 잠긴 칸(쿠팡)](../img/market-account-03.png)

## 계정 삭제하기

> ⚠️ 삭제한 계정은 되돌릴 수 없습니다. 다시 쓰려면 처음부터 연결합니다.

1. 계정 목록에서 지울 계정 줄을 선택합니다.
2. **마켓 계정 수정** 칸 오른쪽 위 **[계정 삭제]**를 선택합니다.
3. "선택하신 계정을 삭제 하시겠습니까?"에서 삭제를 확인합니다.
   - "연결된 마켓 정책이 있습니다."가 나오면: 이 계정을 쓰는 마켓 정책이 있습니다. [마켓 정책](policy-market.md)에서 그 정책을 지우거나 다른 계정으로 바꾼 뒤 다시 합니다.
   - "연결된 상품이 있어 삭제할 수 없습니다."가 나오면: 이 계정으로 마켓에 등록한 상품이 있습니다. [상품 조회 — 일괄처리](product-batch.md)에서 그 상품을 먼저 삭제합니다.

"삭제되었습니다."가 나오고 계정 목록에서 계정이 사라지면 끝입니다.

## 자주 보는 메시지

| 화면 문구 | 뜻과 해결 |
| --- | --- |
| 아이디를 입력해주세요 | 아이디 칸이 비어 있습니다. 마켓 판매자 아이디를 넣습니다. |
| API 연결 상태를 확인해주세요 | 연결 테스트에 성공하지 않은 채 저장했습니다. 연동 상태가 "연결안됨"인 계정의 옵션만 바꿀 때도 나옵니다. 테스트에 성공한 뒤 저장합니다. |
| 계정 등록 갯수를 초과했습니다. 서비스를 업그레이드해주세요. | [부가서비스](glossary.md) "마켓 계정" 한도(모든 마켓 합계)를 넘었습니다. 쓰지 않는 계정을 지우거나 **결제 관리**에서 부가서비스를 늘립니다. |
| 중복된 계정이 존재합니다. | 같은 마켓에 같은 계정(아이디나 API Key)이 연결되어 있습니다. 이미 있는 계정을 고쳐 씁니다. |
| 인증 URL이 만료되었거나 이미 사용되었습니다. [인증 URL 생성]부터 다시 진행해주세요. | eBay 로그인 뒤 받은 주소를 늦게 넣었거나 한 번 쓴 주소입니다. **[인증 URL 생성]**부터 다시 합니다. eBay 문구는 [eBay 마켓 계정 연동](connect-ebay.md)에 모아 두었습니다. |
| 상품이 등록된 계정은 다른 이베이 계정으로 바꿀 수 없습니다. 같은 이베이 계정으로 다시 연결해 주세요. | 상품을 등록한 eBay 계정을 다시 연결하면서 다른 eBay 계정으로 로그인했습니다. 처음 연결한 eBay 계정으로 다시 로그인합니다. |

같은 문구는 [자주 보는 오류 메시지](trouble-errors.md)에도 모아 두었습니다. 그래도 안 되면 [고객센터](support.md) 1:1 문의에 마켓 이름, 연동 아이디, 화면에 나온 문구 그대로, 시도한 시각을 적어 보냅니다. API Key·비밀번호는 적지 않습니다.

## 다음 단계

- 처음 연결했다면 **STEP 4** [기본 정책 만들기](start-policy.md)

## 관련 문서

- [마켓 계정 연동하기](start-market.md)
- [마켓 정책](policy-market.md) — 마켓 계정마다 등록 기본값 정하기
- [결제 관리](payment.md) — 마켓 계정 한도 늘리기