Spresso가이드 Spresso 열기
배포 예정 화면 기준 — 운영(console.spresso.kr)에 반영되면 다시 확인합니다
처음 시작하기 › Spresso 시작 (STEP 1~8)마지막 수정 2026-10-22Markdown

🔗마켓 계정 연동하기

이 문서에서이게 뭔가요?어느 마켓인가요?Spresso에 넣기 (모든 마켓 공통)결과 확인자주 보는 메시지다음 단계관련 문서
💡

이 문서를 마치면 상품을 올릴 마켓의 판매자 계정을 Spresso에 연결할 수 있습니다. (⏱️ 마켓마다 약 15~20분)

📍 메뉴 위치: 마켓 관리 > 마켓 계정 관리
✅ 미리 준비: 마켓 판매자 계정(마켓 계정 만들기)

이게 뭔가요?

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

💡

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

어느 마켓인가요?

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

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

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

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

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

  1. Spresso 왼쪽 사이드바에서 마켓 관리 > 마켓 계정 관리로 이동합니다.

  2. 위쪽 마켓 탭에서 연결할 마켓을 선택합니다.

    • 탭이 없으면 위 💡처럼 플랜의 마켓 범위를 확인합니다.

  3. 오른쪽 아래 [마켓 계정 추가]를 선택합니다. 아래에 마켓 계정 추가 칸이 열립니다.

    마켓 계정 관리의 마켓 탭과 추가 버튼
  4. 마켓 아이디와 연결 정보를 입력합니다.

    • 칸 옆 발급가이드를 선택하면 연결 정보를 받는 방법이 새 창으로 열립니다.

  5. 테스트 버튼을 선택합니다. 대부분은 [API Key 테스트], G마켓·옥션은 [로그인 테스트]입니다. eBay는 [인증 URL 생성]으로 eBay에 로그인한 뒤 완료 화면 주소를 인증 URL에 넣고 [API Key 테스트]를 선택합니다.

    • 칸 아래에 "테스트 성공"이 나오면 다음으로 넘어갑니다.

    • 안 되면: 칸 아래에 "테스트 실패"가, 화면 위에 마켓이 알려 준 이유가 나옵니다. 아래 "자주 보는 메시지"를 봅니다.

    • G마켓·옥션에서 "2차 인증이 필요합니다."가 나오면 ESM (G마켓/옥션) 마켓 계정 연동의 "2차 인증이 필요할 때"를 따릅니다.

  6. 나머지 칸을 정합니다.

    • 자주 사용하는 택배사(국내 마켓): 송장을 보낼 때 쓰는 택배사를 고릅니다. STEP 8 첫 주문 처리하기에서 송장을 넣을 때 여기서 고른 택배사만 나옵니다.

    • 최대 등록 상품 개수(선택): 비워 두면 "제한 없음"입니다.

  7. 칸 오른쪽 위 [변경사항 저장]을 선택합니다. 테스트에 성공해야 이 버튼이 눌립니다.

    마켓 계정 추가 칸의 입력 항목

결과 확인

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

자주 보는 메시지

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

마켓별 메시지와 계정 수정·삭제는 마켓 계정 관리, 그 밖의 문구는 자주 보는 오류 메시지를 봅니다.

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

다음 단계

관련 문서

🙋

이 문서로 해결되지 않으면 화면에 나온 문구로 자주 보는 오류 메시지를 찾거나 고객센터에서 1:1 문의를 남깁니다. 모르는 낱말은 용어집에 있습니다.