서비스 설정 · API 관리
판매채널 API 관리
오픈마켓, 종합몰 등 판매채널의 API 계정을 등록하고 연동 상태를 관리하는 방법을 안내합니다.
왜 필요한가요?
각 판매채널에서 상품 등록 · 주문 수집 · CS 응대 · 정산 확인 등을 개별 로그인 없이 윈셀링 한 곳에서 처리하려면 채널별 API 연동이 필요합니다. 이 페이지에서 채널 API 계정을 등록 · 수정 · 삭제 · 상태 확인 합니다.
지원 채널 유형
| 유형 | 지원 채널 |
|---|
| 오픈마켓 | 스마트스토어 · 11번가 · G마켓 · 옥션 · 카카오톡스토어 · 롯데ON · 알리익스프레스 · 쿠팡 · 토스쇼핑 |
|---|
| 종합몰 | 신세계몰 · 이마트몰 등 신세계 계열 |
|---|
| 전문몰 | 하이마트 · 도매꾹 · 오너클랜 |
|---|
| 자사몰 | Cafe24 · 고도몰 등 |
|---|
ℹ️일부 채널은 서비스 중단 (인터파크 · 위메프 · 위메프+) 으로 신규 등록이 불가합니다. 채널 추가 시 자동으로 안내됩니다.
등록 한도
서비스 이용권(플랜)에 따라 등록 가능 채널 수 상한 이 있습니다. 상단 등록 채널 KPI 카드에서 현재 사용량과 잔여 슬롯을 확인할 수 있습니다.
등록 단계
- 페이지 우상단의 ＋ 채널 추가 버튼을 누릅니다.
- 드롭다운에서 채널타입 → 마켓 아이콘 을 선택합니다. (같은 마켓이 이미 등록되어 있으면 등록 개수가 함께 표시됩니다.)
- 마켓별 등록 화면에서 API Key · Secret · 판매자 ID · 스토어 정보 등 필드를 입력합니다.
- 선택 사항으로 연결 테스트 를 눌러 인증 값이 유효한지 확인합니다.
- 저장 을 누르면 목록에 반영되고, 대부분의 채널은 승인 상태 컬럼에 진행 결과가 표시됩니다.
마켓별 특이사항
| 마켓 | 필수 · 특이 항목 |
|---|
| 스마트스토어 | 커머스 API 애플리케이션 ID · 시크릿, 대표 카테고리 지정 필수 |
|---|
| ESM (G마켓 · 옥션) | 마스터 채널 먼저 등록 후 자식 채널 연결 |
|---|
| 신세계 계열 (신세계몰 · 이마트몰 등) | SSG 마스터 등록 시 하위 신세계 계열 채널이 자동 오픈 |
|---|
| 도매꾹 (판매자) | Open API Key + Private Secret Key 둘 다 필수 |
|---|
| 토스쇼핑 | OAuth 발급 판매자 토큰 · 스토어 정보 입력 |
|---|
| 서비스 중단 | 인터파크 · 위메프 · 위메프+ 는 등록 화면 진입 시 안내 후 종료 |
|---|
KPI 카드 4장
| 카드 | 표시 값 | 보조 지표 |
|---|
| 등록 채널 | 현재 등록 / 플랜 상한 | 사용률 바 · 여유 슬롯 |
|---|
| 승인 완료 | 승인 완료 채널 수 | 완료율(%) |
|---|
| 만료 임박 / 만료 | D-30 이하 · 만료 채널 합계 | 최대 3개 채널 D-N 요약 |
|---|
| 승인 대기 / 실패 | 미승인 채널 수 | 대표 실패 사유(30자) |
|---|
승인 상태 배지
- 완료 — 정상 연동 중 (Key 유효 · API 응답 정상)
- 만료임박 — Key 유효기간 D-30 이내, 갱신 권장
- 만료 — Key 만료, 즉시 갱신 필요
- 미승인 — 승인 대기 · 실패, 사유 확인 후 재시도
- 승인중 — 마켓 승인 진행 중, 마켓 정책에 따라 시간 소요
💡KPI 의 만료 임박 · 미승인 지표가 항상 0에 가깝게 유지되도록 정기적으로 상태를 점검 하는 것이 안정적인 자동 수집·발주 운영의 핵심입니다.
검색
툴바 좌측의 검색 입력창에 마켓명 · 스토어명 · 판매자 ID 일부를 입력하면 실시간으로 목록이 좁혀집니다.
채널타입 필터
칩 그룹에서 원하는 유형을 눌러 오픈마켓 · 종합몰 · 전문몰 · 자사몰 등을 필터링합니다. 각 칩 끝의 숫자는 등록 개수입니다.
승인상태 필터
- 완료 — 승인 완료된 채널만
- 만료임박 / 만료 — 갱신이 필요한 채널만
- 미승인 — 실패 · 대기 상태만 (재시도 대상 확인용)
- 승인중 — 진행 중 채널만
💡필터는 중복 적용 됩니다. 예 : "오픈마켓 × 만료임박" 으로 오픈마켓 중 만료 임박한 채널만 골라볼 수 있습니다.
목록 컬럼의 의미
| 컬럼 | 표시 내용 |
|---|
| 연동 | API 활성 여부 (ON / OFF 토글) |
|---|
| 채널 · 관리 | 마켓 · 판매자 ID · 스토어 정보 |
|---|
| 승인 상태 | 완료 / 만료임박 / 만료 / 미승인 / 승인중 배지 |
|---|
| 상품 | 상품 등록 · 수정 API 지원 여부 |
|---|
| 주문 | 주문 수집 API 지원 여부 |
|---|
| CS | 상품문의 · CS · 리뷰 API 지원 여부 |
|---|
| 정산 | 정산 내역 API 지원 여부 |
|---|
| 자동발주 | 자동발주 시나리오 지원 여부 |
|---|
| 바로가기 | 마켓 관리자 · 문의 등 유용한 링크 |
|---|
| 메모 · 등록/수정 | 내부 메모 · 최근 등록/수정 이력 |
|---|
ON/OFF 토글
연동 컬럼의 토글을 눌러 일시 중지 · 재개 를 즉시 반영합니다. OFF 상태에서는 자동주문수집 · 자동발주 스케쥴이 실행되지 않습니다.
⏸️중요 채널을 OFF 하기 전에 진행 중 주문 · CS 처리 여부 를 반드시 확인하세요. 재개 시 놓친 이력은 이전 로그 · 실패 로그 에서 별도로 확인해야 합니다.
연결 테스트
채널 등록 / 수정 화면 하단의 🔗 연결 테스트 버튼으로 저장 전에 인증을 확인합니다. 마켓별로 다음을 검증합니다.
- 스마트스토어 — 애플리케이션 ID / 시크릿 페어 유효성
- 11번가 · G마켓 · 옥션 — 판매자 ID · Key 조합 유효성
- 도매꾹 (판매자) — Open API Key + Private Secret Key 둘 다 검증
- 토스쇼핑 — 판매자 토큰 유효성
💡테스트가 실패하면 어떤 값이 잘못됐는지 · 어떤 응답 코드가 왔는지 안내됩니다. 저장 전에 수정한 뒤 재시도하세요.
저장 시 자동 검증
- 필수 항목 누락 검사 (마켓별로 다름)
- 같은 판매자 ID · 마켓 조합의 중복 등록 방지 — 판매자 / 공급자 서비스는 서로 별개로 취급됩니다.
- Key 형식 검사 (자릿수 · 문자 종류)
⚠️저장 후 승인 상태가 미승인 으로 표시되면 필드 값이 형식상 유효하지만 마켓 서버가 거절한 상태입니다. 마켓 관리자에서 API 연동 신청 · 승인 대기 를 확인하세요.
수정
- 목록에서 채널 행의 관리 · 수정 링크(연필 아이콘)를 누릅니다.
- 필드 값을 변경 후 필요 시 연결 테스트 를 실행합니다.
- 저장 을 눌러 반영합니다.
🔑Secret Key · API Key 를 새 값으로 저장하면 Key 변경일시 가 갱신되고, 연결된 자동주문수집 · 자동발주 스케쥴 이 다음 사이클부터 새 Key 로 호출합니다.
삭제
- 목록에서 관리 · 삭제 를 선택합니다.
- 확인 다이얼로그에서 삭제를 승인합니다.
- 즉시 목록에서 제거되고, 관련 스케쥴은 중지됩니다.
🗑️삭제된 채널의 과거 주문 · 정산 데이터 는 유지되지만 API 호출은 이후 불가 합니다. 일시 중지가 필요하면 삭제 대신 ON/OFF 토글 을 사용하세요.
만료 갱신 흐름
- KPI 만료 임박 / 만료 카드에서 대상 채널을 확인합니다.
- 승인상태 필터 만료임박 / 만료 로 목록을 좁힙니다.
- 해당 채널 수정 화면에서 마켓에서 재발급받은 새 Key 를 입력 · 저장합니다.
- 승인 상태가 완료 로 돌아오는지 확인합니다.
![]()
