🛒마켓 계정 관리

이 문서에서이게 뭔가요?무엇을 하려고 하나요?화면 구성마켓마다 다른 것마켓 계정 추가하기테스트 결과계정 옵션계정 수정·다시 연결하기계정 삭제하기자주 보는 메시지다음 단계관련 문서

💡

이 문서를 마치면 마켓 계정을 추가·수정·삭제하고, 계정마다 등록 개수·택배사 같은 옵션을 정할 수 있습니다. (⏱️ 약 5분, 연결 정보 준비는 마켓별 문서)

📍 메뉴 위치: 마켓 관리 > 마켓 계정 관리
✅ 미리 준비: 마켓 판매자 계정과 연결 정보(마켓별 연동 문서), 쿠팡·스마트스토어·11번가·롯데온은 판매자센터에 내 IP 등록

이게 뭔가요?

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

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

무엇을 하려고 하나요?

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

화면 구성

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

⚠️

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

마켓마다 다른 것

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

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

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

마켓 계정 추가하기

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

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

테스트 결과

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

💡

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

계정 옵션

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

계정 수정·다시 연결하기

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

⚠️

이 계정으로 등록한 상품이 있으면 저장해도 연결 정보는 아래 칸만 바뀝니다. 옵션과 연동 상태는 바뀝니다.

바뀜: 쿠팡 Secret Key, 스마트스토어 애플리케이션 시크릿, G마켓·옥션 ESM 비밀번호, eBay 다시 인증(같은 eBay 계정일 때)
안 바뀜: 스마트스토어 애플리케이션 ID, 11번가 API Key, 롯데온 API Key — "변경사항을 저장하였습니다."가 나와도 예전 값이 그대로 남습니다. 이 값을 바꿔야 하면 고객센터 1:1 문의로 알립니다.

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

계정 삭제하기

⚠️

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

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

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

자주 보는 메시지

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

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

다음 단계

STEP 4

처음 연결했다면 기본 정책 만들기