# eBay API 키 발급

> 💡 이 문서를 마치면 eBay Developers Program에서 Spresso에 넣을 **App ID·Cert ID·Redirect URI(RuName)** 세 가지를 받을 수 있습니다. (⏱️ 가입 승인 대기 영업일 1일 이상 + 키 발급 약 15분)
>
> 📍 메뉴 위치: [eBay Developers Program](https://developer.ebay.com/) **Application Keys** → 키 세트의 **Notifications**·**User Tokens**\
> ✅ 미리 준비: 이메일 주소, 영문 이름·연락처·주소, eBay 판매자 계정([eBay 가입](signup-ebay.md) — Spresso 연결 때 씀)

## 이게 뭔가요?

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

받은 키는 두 곳에 씁니다.

| 쓰는 곳 | 넣는 값 |
| --- | --- |
| [eBay 마켓 계정 연동](connect-ebay.md) — 상품 등록·주문 | App ID · Cert ID · Redirect URI(RuName) |
| [수집처 만들기](collector-create.md) **[사이트 설정]** — eBay 상품 수집 | Client ID = App ID · Client Secret = Cert ID |

순서는 넷입니다.

1. eBay Developers Program에 가입하고 승인을 기다립니다.
2. Production 키 세트를 만듭니다(App ID·Cert ID).
3. 계정 삭제 알림 주소를 넣어 키 세트를 켭니다.
4. Redirect URI(RuName)를 만듭니다.

## 1️⃣ eBay Developers Program 가입하기

1. **[eBay Developers Program 가입 화면](https://developer.ebay.com/signin?tab=register)**에 접속합니다.
2. **Username**(아이디), **Password**(8~64자, 영문·숫자·기호 `!@#$%^*-_+=` 를 하나씩 넣음), **Email**과 **Re-enter Email**을 입력합니다.
3. **I have read and accept the eBay API License Agreement**에 체크하고 **[Join]**을 선택합니다.

   ![eBay Developers 가입 입력 칸](../img/ebay-key-01.png)

4. 받은 메일의 링크를 눌러 가입을 마칩니다. 메일이 없으면 스팸함을 보고, 그래도 없으면 가입 화면의 **[Re-send it]**을 선택합니다.
5. 로그인 화면에 "Thank you for registering… pending approval, which takes at least one business day."가 나오면 eBay가 계정을 검토하는 중입니다. 영업일 1일 이상 기다린 뒤 로그인합니다.

   ![eBay Developers 가입 승인 대기 안내](../img/ebay-key-02.png)

## 2️⃣ Production 키 세트 만들기

1. 승인된 계정으로 [eBay Developers Program](https://developer.ebay.com/signin)에 로그인합니다.
2. 키 세트 만들기 화면에서 **Application Title**에 알아볼 이름(예: Spresso, 3자 이상)을 넣고, **Environment**는 **Production**을 고른 뒤 **[Create keyset]**을 선택합니다.
   - **Sandbox**는 시험용이라 Spresso에서 쓰지 않습니다.

   ![키 세트 이름과 Production 선택](../img/ebay-key-03.png)

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

   ![발급된 App ID와 Cert ID](../img/ebay-key-04.png)

> ⚠️ Cert ID는 비밀번호처럼 다룹니다. 다른 사람에게 보내거나 문의 글에 적지 않습니다.

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

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

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

![꺼진 키 세트의 알림 설정 링크](../img/ebay-key-05.png)

**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]**를 선택합니다.

   ![계정 삭제 알림 주소와 토큰 입력](../img/ebay-key-06.png)

> ⚠️ 주소와 토큰은 한 글자라도 다르면 eBay 확인이 실패합니다. 위 글자를 그대로 복사해 붙여 넣습니다(앞뒤 공백 없이).
>
> **Exempted from Marketplace Account Deletion**(알림 면제)은 켜지 않습니다. 면제 사유가 Spresso 쓰임과 맞지 않습니다.

저장한 뒤 **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.**)을 선택합니다.

   ![Redirect URL 추가 버튼](../img/ebay-key-07.png)

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

   ![RuName 만들기 전 주소 확인 창](../img/ebay-key-08.png)

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 연결 때 그 화면의 주소를 씁니다.

   ![만들어진 RuName](../img/ebay-key-09.png)

## 결과 확인

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

![Application Keys의 키 세트](../img/ebay-key-10.png)

> ⚠️ **Rotate (Reset) Cert ID**는 누르지 않습니다. Cert ID가 바뀌면 Spresso 연결과 eBay 수집이 멈춥니다.

## 안 될 때

| 상황 | 해결 |
| --- | --- |
| 가입 메일이 오지 않음 | 스팸함을 봅니다. 없으면 가입 화면의 **[Re-send it]**을 선택합니다. |
| 로그인하면 승인 대기 안내만 나옴 | eBay 검토가 끝나지 않았습니다. 영업일 1일 이상 기다립니다. |
| 키 세트가 계속 **disabled** | 3️⃣의 주소·토큰이 한 글자라도 다르지 않은지, 앞뒤 공백이 없는지 보고 다시 **[Save]**합니다. |

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

## 다음 단계

- [eBay 마켓 계정 연동](connect-ebay.md) — 받은 세 값을 Spresso에 넣어 연결
- [수집처 만들기](collector-create.md) — eBay 상품을 수집하려면 **[사이트 설정]**에 Client ID·Client Secret

## 관련 문서

- [eBay 가입](signup-ebay.md)
- [이베이 시작하기](ebay-start.md)