# 솔루션/Open API 연동하기

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

***

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

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

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

<figure><img src="/files/ApMzmLci3iEnjPSASLfH" alt=""><figcaption></figcaption></figure>

***

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

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

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

<figure><img src="/files/x6LmvLv5kMKP6h5Xu7w0" alt=""><figcaption></figcaption></figure>

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

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

***

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

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

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

<figure><img src="/files/yBPNOpJr4qGF7Ae6vCYi" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="/files/rZ5uunJ6kJcdkQLIsajO" alt=""><figcaption></figcaption></figure>

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

***

### 3. Open API 키 발급

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

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

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

<figure><img src="/files/RFu1k0CI6hJSVj1xdUR1" alt=""><figcaption></figcaption></figure>

**입력 항목:**

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

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

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

<figure><img src="/files/yfuFyEc9Gihozshyk2Fb" alt=""><figcaption></figcaption></figure>

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

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

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

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

<figure><img src="/files/BiwbFtftDCjeIRaahTju" alt=""><figcaption></figcaption></figure>

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

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

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

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

***

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

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

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

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

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

<div><figure><img src="/files/0ATmkgXVspRPEau44i2d" alt=""><figcaption></figcaption></figure> <figure><img src="/files/efwWFAReGTguyMJ08lwC" alt=""><figcaption></figcaption></figure></div>

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

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://shopping-docs.toss.im/support/solution-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.