솔루션/Open API 연동하기

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

---

1. 연동 키 화면 진입

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

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

---

2. 제휴 솔루션 키 발급

2-1. 업체 선택

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

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

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

---

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

2-2. 키 발급 완료

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

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

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

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

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

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

---

3. Open API 키 발급

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

3-1. 업체 정보 입력

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

입력 항목:

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

3-2. 키 발급 완료

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

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

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

3-3. Direct API 키 수정

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

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

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

3-4. 연동 업체 키 추가

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

---

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

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

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

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

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

4-2. 온보딩 완료 후

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