eBay 마켓 계정 연동
이 문서에서
이게 뭔가요?어느 쪽인가요?🚚 (선택) eBay 비즈니스 정책 만들기💫 Spresso에 eBay 마켓 계정 추가하기결과 확인자주 보는 메시지eBay에서 지금 되는 것다음 단계관련 문서이 문서를 마치면 eBay 판매자 계정을 Spresso에 연결하고, 필요하면 eBay에 비즈니스 정책(결제·반품·배송)을 직접 만들 수 있습니다. (⏱️ 연결 약 5분, 정책을 직접 만들면 약 20분)
📍 메뉴 위치: (선택) eBay Account settings > Business Policies → Spresso 마켓 관리 > 마켓 계정 관리
✅ 미리 준비: eBay 판매자 계정(eBay 가입), eBay API 키 발급에서 받은 App ID·Cert ID·Redirect URI(RuName), 브라우저 팝업 허용
이게 뭔가요?
Spresso가 eBay에 상품을 올리고 주문을 가져오려면 eBay 판매자 계정을 Spresso에 연결해야 합니다. 셀러가 eBay Developers Program에서 직접 발급한 키 세 가지(App ID·Cert ID·Redirect URI)를 Spresso에 넣고, eBay 판매자 계정으로 한 번 로그인해 Spresso가 그 계정을 쓰도록 허락합니다. 키가 아직 없으면 eBay API 키 발급부터 합니다.
eBay에 상품을 올리려면 결제(Payment)·반품(Return)·배송(Shipping) 세 가지 비즈니스 정책도 있어야 합니다. 이 정책은 eBay에서 직접 만들거나, 계정을 연결한 뒤 Spresso가 대신 만들게 할 수 있습니다.
어느 쪽인가요?
| 비즈니스 정책을 | 할 일 |
|---|---|
| Spresso가 대신 만들게 함 | 아래 "eBay 비즈니스 정책 만들기"를 건너뛰고 "Spresso에 eBay 마켓 계정 추가하기"부터 합니다. 연결한 뒤 이베이 시작하기 7단계 판매 설정이나 마켓 정책 eBay 탭의 [새로 만들기]로 만듭니다. |
| eBay에서 직접 만듦(정책을 자세히 정하고 싶을 때) | 아래 "eBay 비즈니스 정책 만들기"부터 차례로 합니다. |
| 이미 eBay에 정책이 있음 | "Spresso에 eBay 마켓 계정 추가하기"만 합니다. |
🚚 (선택) eBay 비즈니스 정책 만들기
eBay에 로그인한 뒤 왼쪽 위 이름을 선택하고 Account settings → Business Policies를 선택합니다.
[Create policy]를 선택해 Payment, Return, Shipping 정책을 하나씩 만듭니다.
Payment: eBay에서 결제를 받는 방법을 정하고 [Save]를 선택합니다.
Policy name: Payment 정책 이름을 자유롭게 입력합니다.
Payment methods managed by eBay: 체크하면 구매와 동시에 결제를 받습니다.

Return: eBay에 올린 상품의 반품 방법을 정하고 [Save]를 선택합니다.
Policy name: Return 정책 이름을 자유롭게 입력합니다.
Domestic returns: 미국으로 배송된 상품의 변심 반품 방법을 정합니다.
Allowed within: 변심 반품을 받는 기한
Return shipping paid by: 변심 반품 배송비를 누가 내는지
Refund method: 반송된 뒤 처리 방법
International returns: 미국 밖으로 배송된 상품의 변심 반품 방법을 정합니다.
💡Return 정책과 관계없이, 불량이거나 다른 상품이 도착하면 반품이나 환불을 해 줘야 합니다.
해외 반품은 반송 배송비가 많이 나올 수 있어 받지 않기를 추천합니다.
eBay에서 Domestic은 상품이 등록된 국가(미국)이고, International은 미국 밖 지역입니다.
Shipping: 지역별 배송 방법을 정하고 [Save]를 선택합니다(eBay 공식 문서 참고).
Policy name: Shipping 정책 이름을 자유롭게 입력합니다.
Shipping method: 무게·크기에 맞는 배송 방법을 고릅니다.
Cost type: 지역별 배송비를 같게 할지 다르게 할지 정합니다.
Add primary service: 한국에서 그 지역으로 보내는 배송 방법과 배송비를 입력합니다.
Domestic(미국)
우체국 K-Packet: Economy Shipping from outside US (11~23영업일)
우체국 항공 소포: Standard Shipping from outside US (5~10영업일)
특송(EMS, DHL, UPS 등): Expedited Shipping from outside US (1~4영업일)
International(미국 밖)
우체국 항공 소포: Economy International Shipping (13~23영업일)
Handling time: 주문을 확인한 뒤 발송 처리까지 걸리는 시간을 고릅니다.
Excluded locations: 주문을 받지 않을 지역을 고릅니다.
APO/FPO(미군 부대·군사 우편 주소): 배송이 한없이 늦어질 수 있는 지역
US Protectorates(미국령): 괌·사이판·푸에르토리코 등 배송비가 많이 나오는 지역
Africa(아프리카 전체): 배송 추적이 어렵고 분실이 잦은 지역
South America(남미 전체): 아프리카와 같은 이유
Central America and Caribbean(중남미·카리브해 전체): 아프리카와 같은 이유

💫 Spresso에 eBay 마켓 계정 추가하기
Spresso에 로그인한 뒤 마켓 관리 > 마켓 계정 관리로 이동합니다.
eBay 탭을 선택하고 [마켓 계정 추가]를 선택합니다.
아이디 칸에 eBay 아이디를 입력합니다.
eBay API 키 발급에서 받은 값을 넣습니다.
App ID (Client ID): 키 세트의 App ID
Cert ID (Client Secret): 키 세트의 Cert ID
Redirect URI: User Tokens 표의 RuName 값(주소가 아니라 이름)
[인증 URL 생성]을 선택합니다. 새 탭에 eBay 로그인 화면이 열립니다.
새 탭이 열리지 않으면 브라우저에서 Spresso 사이트의 팝업을 허용하고 다시 선택합니다.
새 탭에서 eBay 판매자 계정(Developers 계정이 아님)으로 로그인하고 동의합니다.
"Authorization successfully completed."가 나오면 그 탭의 주소창 주소 전체를 복사합니다(
https://auth2.ebay.com/oauth2/ThirdPartyAuthSucessFailure?isAuthSuccessful=true&code=…).

Spresso로 돌아와 인증 URL 칸에 복사한 주소를 그대로 붙여 넣습니다.
[API Key 테스트]를 선택합니다. "인증이 완료되었습니다."와 칸 아래 초록 "테스트 성공"이 나오면 다음으로 넘어갑니다.
안 되면: 아래 "자주 보는 메시지"를 봅니다.
(선택) 최대 등록 상품 개수를 정합니다. 비워 두면 목록에 "제한 없음"으로 나옵니다.
[변경사항 저장]을 선택합니다.

eBay 로그인 뒤 받은 주소는 한 번만, 잠깐 동안만 쓸 수 있습니다. 주소를 복사하면 바로 붙여 넣고 테스트합니다. 시간이 지났거나 이미 썼으면 [인증 URL 생성]부터 다시 합니다.
결과 확인
"변경사항을 저장하였습니다."가 나오고 eBay 탭 계정 목록에 아이디가 생기고 연동 상태가 "연결"(초록)이면 끝입니다.
자주 보는 메시지
| 화면 문구 | 뜻과 해결 |
|---|---|
| App ID (Client ID)를 입력해주세요 · Cert ID (Client Secret)를 입력해주세요 · Redirect URI를 입력해주세요 | 그 칸이 비어 있습니다. eBay API 키 발급에서 받은 값을 넣습니다. |
| 인증 URL을 입력해주세요 | 인증 URL 칸이 비어 있습니다. 5~6단계대로 eBay 로그인 뒤 주소를 붙여 넣습니다. |
| 인증 URL에서 authorization code를 찾을 수 없습니다. | eBay 로그인을 마친 뒤의 주소가 아닙니다(로그인 화면 주소 등). 로그인 완료 화면("Authorization successfully completed.")의 주소창 주소 전체를 붙여 넣습니다. |
| 인증 URL이 만료되었거나 이미 사용되었습니다. [인증 URL 생성]부터 다시 진행해주세요. | 주소를 너무 늦게 넣었거나 한 번 쓴 주소입니다. [인증 URL 생성]부터 다시 합니다. |
| App ID 또는 Cert ID가 맞지 않습니다. | App ID·Cert ID가 틀렸습니다. Application Keys 화면의 Production 키 세트 값을 다시 복사합니다(Sandbox 키가 아닌지 확인). |
| 이베이 연결에 실패했습니다. 입력한 App ID·Cert ID·Redirect URI를 확인해주세요. | 세 값 중 하나가 맞지 않습니다. 특히 Redirect URI에 RuName 이름을 넣었는지, 키 세트가 켜져 있는지(eBay API 키 발급 3️⃣) 확인합니다. |
| 인증 URL 생성에 실패했습니다. · 토큰 교환에 실패했습니다. | 연결 중에 문제가 생겼습니다. 잠시 뒤 [인증 URL 생성]부터 다시 합니다. |
| 이베이 연결을 완료해주세요 | 테스트를 마치지 않고 저장했습니다. 7단계 [API Key 테스트]를 성공한 뒤 저장합니다. |
| 상품이 등록된 계정은 다른 이베이 계정으로 바꿀 수 없습니다. 같은 이베이 계정으로 다시 연결해 주세요. | 상품을 등록한 계정을 다시 연결하면서 다른 eBay 판매자 계정으로 로그인했습니다. 처음 연결한 eBay 계정으로 다시 로그인합니다. |
중복 계정·계정 한도처럼 모든 마켓에 같은 문구는 마켓 계정 관리에 있습니다. 그래도 안 되면 고객센터 1:1 문의에 마켓 이름(eBay), 연동 아이디, 화면에 나온 문구 그대로, 시도한 시각을 적어 보냅니다. Cert ID와 eBay 비밀번호는 적지 않습니다.
eBay에서 지금 되는 것
상품: 등록·수정·품절·삭제가 됩니다.
주문: 주문을 가져옵니다. 금액은 원화와 달러로, 품목 번호와 받는 나라가 함께 보입니다(주문 조회).
발주 처리: eBay에는 발주 확인 단계가 없어 눌러도 eBay에 아무것도 보내지 않습니다.
송장 전송: 아직 eBay로 보내지 못합니다. 송장 전송 창에서 eBay 주문은 늘 "전송 불가능"으로 셉니다.
문의: 구매자 메시지를 가져와 답변합니다. 메시지는 주문·상품과 연결되지 않습니다(문의 조회).
eBay 탭에는 자주 사용하는 택배사 칸이 없습니다. 연결한 계정을 지우려면 이 계정으로 등록한 상품을 모두 삭제하고 이 계정을 쓰는 마켓 정책 연결도 풀어야 합니다. 그다음 [계정 삭제]를 선택합니다(마켓 계정 관리).
다음 단계
비즈니스 정책과 마켓 정책을 한 번에 만들려면 이베이 시작하기 7단계 판매 설정
관련 문서
이 문서로 해결되지 않으면 화면에 나온 문구로 자주 보는 오류 메시지를 찾거나 고객센터에서 1:1 문의를 남깁니다. 모르는 낱말은 용어집에 있습니다.