# 솔루션/Open API 연동하기

## 제휴 솔루션 / Direct API 연동 키 발급 가이드

***

### 1. 연동 키 화면 진입

토스셀러 좌측 메뉴에서 **쇼핑 > 연동 관리**로 이동합니다.

연동 관리 페이지에 진입하면 **"연동 업체 키"** 영역에서 키를 발급하고 관리할 수 있습니다.

<figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2FoIeOMHhuBXoDMQf2Wv4E%2Fimage.png?alt=media&#x26;token=75c8878c-1437-458d-8f7e-d7b33b404210" alt=""><figcaption></figcaption></figure>

***

### 2. 제휴 솔루션 키 발급

#### 2-1. 업체 선택

**"API 키 발급하기"** 버튼을 클릭하면 업체 선택 드롭다운이 나타납니다.

<figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2F1plcpnWg9lX6G15uPcPw%2Fimage.png?alt=media&#x26;token=b47ccfb6-66f1-4559-8231-f72f1202df9b" alt=""><figcaption></figcaption></figure>

지원하는 통합솔루션 업체 목록은 다음과 같습니다.

* 플레이오토
* 사방넷
* 샵링커
* EC모니터
* 이지어드민
* 이지싱크
* 샵플링
* 셀픽
* 발주모아
* 가비아커머스

***

> **주의:** 업체를 선택하지 않고 발급 버튼을 클릭하면 발급이 진행되지 않습니다. 반드시 업체를 먼저 선택해 주세요.

#### 2-2. 키 발급 완료

업체를 선택하고 발급을 완료하면 **"내 연동 키"** 영역에 발급된 키 정보가 표시됩니다.

<figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2F2F4AMwzG51hgfgi2mP7i%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-27%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%202.54.02.png?alt=media&#x26;token=b4ccbc23-37d7-4b5c-888d-2624efcb2913" alt=""><figcaption></figcaption></figure>

**제휴 솔루션 키 발급 시 제공되는 정보:**

| 항목         | 설명                      |
| ---------- | ----------------------- |
| 업체명        | 선택한 통합솔루션 업체 (예: 플레이오토) |
| Access Key | API 인증에 사용되는 액세스 키      |
| Secret Key | API 인증에 사용되는 시크릿 키      |
| 로그인 ID     | 연동에 필요한 로그인 ID          |
| 셀러 ID      | 셀러 고유 식별 ID             |

#### 2-3. 제휴 솔루션 키 수정

발급된 제휴 솔루션 키의 **수정** 버튼을 클릭하면 다음 작업이 가능합니다:

<figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2F70bRYlhj8sOgaunbaGHG%2Fimage.png?alt=media&#x26;token=ae0c6a4f-05bc-483b-a0cf-6106747dd5ac" alt=""><figcaption></figcaption></figure>

* 업체명(이름) 변경
* 키 삭제

***

### 3. Open API 키 발급

제휴 솔루션이 아닌 직접 연동(Direct API)을 사용하는 경우의 키 발급 방법입니다.

#### 3-1. 업체 정보 입력

업체 선택 시 "직접 연동 (Direct API)"를 선택하거나, Open API 키 영역에서 업체 정보를 입력합니다.

<figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2Fh4bDNRL2yyduPtu1hIoi%2Fimage.png?alt=media&#x26;token=ef9bbeed-8180-444a-8e4e-6b3a477137e6" alt=""><figcaption></figcaption></figure>

**입력 항목:**

| 항목    | 설명                   |
| ----- | -------------------- |
| 업체명   | 연동할 업체의 이름           |
| IP 주소 | API 호출에 사용할 서버 IP 주소 |

#### 3-2. 키 발급 완료

발급이 완료되면 **Direct API 키** 정보가 표시됩니다.

<figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2FCg09X2geLR4PbJhoAvKh%2F%E1%84%89%E1%85%B3%E1%84%8F%E1%85%B3%E1%84%85%E1%85%B5%E1%86%AB%E1%84%89%E1%85%A3%E1%86%BA%202026-03-27%20%E1%84%8B%E1%85%A9%E1%84%92%E1%85%AE%205.44.02.png?alt=media&#x26;token=be5b68b9-ef20-4b73-94aa-1af6095cc3b2" alt=""><figcaption></figcaption></figure>

**Direct API 키 발급 시 제공되는 정보:**

| 항목         | 설명                 |
| ---------- | ------------------ |
| 업체명        | 입력한 업체명            |
| Access Key | API 인증에 사용되는 액세스 키 |
| Secret Key | API 인증에 사용되는 시크릿 키 |
| IP 주소      | 등록한 서버 IP 주소       |

#### 3-3. Direct API 키 수정

발급된 Direct API 키의 **수정** 버튼을 클릭하면 다음 작업이 가능합니다:

<figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2F5xR7Ud3sTDkcAPN2zwyO%2Fimage.png?alt=media&#x26;token=eedf12b6-f8fa-45fe-904a-c3c5214189cb" alt=""><figcaption></figcaption></figure>

* 업체명 수정
* IP 주소 수정
* 키 삭제

> 수정 후 저장하면 **"변경한 내용을 저장했어요"** 토스트 메시지가 표시됩니다.

#### 3-4. 연동 업체 키 추가

이미 키가 발급된 상태에서 추가 연동 업체 키가 필요한 경우, **"연동업체 키 추가"** 를 통해 새로운 키를 발급받을 수 있습니다.

***

### 4. 최초 온보딩 시 연동 키 발급

> 이 섹션은 **신규 입점 셀러가 최초 온보딩을 진행하는 경우**에 해당합니다.

#### 4-1. 토스페이 청약 전 상태

최초 온보딩 진행 시 **토스페이 청약이 완료되기 전에는 연동 키를 발급받을 수 없습니다.**

연동 키 화면에 진입하면 키 발급 버튼이 비활성화 상태로 표시됩니다.

<div><figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2Fg2DTgGvxz224orV9jyFx%2Fimage.png?alt=media&#x26;token=ccb82485-aa55-4928-9cc1-8f3fcd51b569" alt=""><figcaption></figcaption></figure> <figure><img src="https://3930934899-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnCpSEbYC3GXKjfhVqdVo%2Fuploads%2FpantBasimW8q5o9JWE06%2Fimage.png?alt=media&#x26;token=10ad7d29-30f1-49f8-9c98-eee6ba8fb439" alt=""><figcaption></figcaption></figure></div>

#### 4-2. 온보딩 완료 후

토스페이 청약이 완료되면 정상적으로 연동 키 발급이 가능해지며, 위 **2번(통합솔루션)** 또는 **3번(Direct API)** 절차에 따라 키를 발급받으면 됩니다.