🔑eBay API 키 발급

이게 뭔가요?

Spresso는 셀러가 eBay에서 직접 발급한 키로 eBay에 연결합니다. 키는 eBay Developers Program(eBay 개발자 사이트)에서 받습니다. eBay 판매자 계정과는 따로 가입합니다.

받은 키는 두 곳에 씁니다.

순서는 넷입니다.

1. eBay Developers Program에 가입하고 승인을 기다립니다.

2. Production 키 세트를 만듭니다(App ID·Cert ID).

3. 계정 삭제 알림 주소를 넣어 키 세트를 켭니다.

4. Redirect URI(RuName)를 만듭니다.

1️⃣ eBay Developers Program 가입하기

1. eBay Developers Program 가입 화면에 접속합니다.

2. Username(아이디), Password(8~64자, 영문·숫자·기호 !@#$%^*-_+= 를 하나씩 넣음), Email과 Re-enter Email을 입력합니다.

3. I have read and accept the eBay API License Agreement에 체크하고 [Join]을 선택합니다.

   

4. 받은 메일의 링크를 눌러 가입을 마칩니다. 메일이 없으면 스팸함을 보고, 그래도 없으면 가입 화면의 [Re-send it]을 선택합니다.

5. 로그인 화면에 "Thank you for registering… pending approval, which takes at least one business day."가 나오면 eBay가 계정을 검토하는 중입니다. 영업일 1일 이상 기다린 뒤 로그인합니다.

   

2️⃣ Production 키 세트 만들기

1. 승인된 계정으로 eBay Developers Program에 로그인합니다.

2. 키 세트 만들기 화면에서 Application Title에 알아볼 이름(예: Spresso, 3자 이상)을 넣고, Environment는 Production을 고른 뒤 [Create keyset]을 선택합니다.

   • Sandbox는 시험용이라 Spresso에서 쓰지 않습니다.

   

3. "Your Production keyset is ready"가 나오면 App ID (Client ID)와 Cert ID (Client Secret)를 복사 아이콘으로 복사해 둡니다. Dev ID는 쓰지 않습니다.

   

3️⃣ 계정 삭제 알림 주소 넣기 (키 세트 켜기)

새 키 세트는 처음에 꺼져 있습니다(Your keyset is currently disabled). eBay는 구매자가 eBay 계정을 지우면 그 사실을 받을 주소를 등록해야 키를 켜 줍니다. Spresso가 알림을 받으므로 아래 Spresso 주소를 그대로 넣습니다.

Application Keys 화면의 Production 키 세트에서 marketplace deletion/account closure notification 링크를 선택합니다. 키 세트가 이미 켜져 있으면 App ID 아래 Notifications를 선택합니다.

Alerts & Notifications 탭에서 아래 번호대로 넣습니다.

1. Marketplace Account Deletion을 고릅니다.

2. Email to notify if marketplace account deletion notification endpoint is down에 연락받을 이메일을 넣고 [Save]를 선택합니다.

3. Marketplace account deletion notification endpoint에 아래 주소를 넣습니다.
   https://auth.spresso.kr/api/auth/ebayNotification

4. Verification token에 아래 값을 넣습니다.
   NOWSTONE_SPRESSO_EBAY_NOTIFICATION_VALIDATION_TOKEN

5. [Save]를 선택합니다.

   

저장한 뒤 Application Keys 화면에서 App ID·Cert ID가 흐리지 않고 보이면 키 세트가 켜진 것입니다.

4️⃣ Redirect URI(RuName) 만들기

1. Application Keys 화면에서 App ID 아래 User Tokens를 선택합니다.

2. Get a Token from eBay via Your Application의 + Add eBay Redirect URL(처음이면 Click here to add one.)을 선택합니다.

   

3. Confirm your Legal Address 창에서 개인이면 Individual, 사업자면 Business를 고르고 이름·이메일·휴대폰·주소를 영문으로 입력합니다. [Continue to create RuName]을 선택합니다.

   • 키에 문제가 생기면 eBay가 이 연락처로 연락합니다.

   

4. Your eBay Sign-in Settings 표에 새 줄이 생기고 OAuth Enabled에 초록 체크가 보입니다. 이 줄의 RuName (eBay Redirect URL name) 값이 Spresso의 Redirect URI입니다. 복사해 둡니다.

   • 줄을 펼쳤을 때 나오는 Your auth accepted URL·Your auth declined URL은 비워 둡니다. 비우면 eBay 기본 완료 화면으로 돌아오고, Spresso 연결 때 그 화면의 주소를 씁니다.

   

결과 확인

Application Keys 화면에서 Production 키 세트의 App ID·Cert ID가 보이고, User Tokens에 RuName 한 줄이 있으면 끝입니다. 나중에 키를 다시 볼 때도 이 화면을 씁니다. Cert ID는 눈 아이콘을 선택하면 보입니다.

안 될 때

그래도 안 되면 고객센터 1:1 문의에 막힌 단계와 화면 문구를 적어 보냅니다. Cert ID·비밀번호는 적지 않습니다.

다음 단계

eBay 마켓 계정 연동

받은 세 값을 Spresso에 넣어 연결

🔍수집처 만들기

eBay 상품을 수집하려면 [사이트 설정]에 Client ID·Client Secret

관련 문서

• eBay 가입

• 이베이 시작하기