마켓 추가하기

Hanaro는 다음 3개 마켓을 1차로 지원합니다 (Wave β). 각 마켓의 공식 API 키 또는 OAuth 토큰을 발급받아 등록합니다.

RiskLevel — Hanaro는 마켓의 약관 회색지대(세션 자동화 등) 사용 시 위험도를 명시적으로 표시합니다. 자세한 내용은 FAQ — 공식 API와 세션 자동화의 차이 참조.

스마트스토어

1. 네이버 셀러센터에서 API 권한 받기

1. 네이버 커머스 API 센터에 셀러 계정으로 로그인.
2. 애플리케이션 등록:
   • 애플리케이션 이름: Hanaro (자유)
   • 사용 용도: 주문 조회 / 발송 처리
3. 발급된 클라이언트 ID, 클라이언트 시크릿 복사.

2. Hanaro에서 등록

1. 설정 → 마켓 계정 → + 추가 → 스마트스토어 선택.
2. 입력:
   • 클라이언트 ID
   • 클라이언트 시크릿
   • 판매자 ID (선택, 멀티 셀러 식별용)
3. 연결 테스트 → 성공 시 저장.

3. WebView2 로그인 흐름 (선택)

일부 운영 작업(예: 주문 상태 변경 — 발송준비 → 배송중)은 공식 API로 노출되지 않아 세션 기반 자동화를 사용합니다. 이때 처음 한 번 WebView2 창에 네이버 로그인이 필요합니다.

주의: 세션 자동화는 네이버 약관의 회색지대(RiskLevel: 중간)에 해당합니다. 사용 전 동의 다이얼로그가 표시됩니다. 자동화를 원치 않으면 공식 API만으로 운영 가능합니다.

첫 로그인 절차

1. 설정 → 마켓 계정 → + 추가 → 스마트스토어 선택.
2. WebView2 로그인 버튼 클릭 → 네이버 로그인 모달 창이 뜹니다.
3. 모달 안에서 네이버 ID·비밀번호 입력 → 캡차 → 2FA(설정된 경우)까지 진행.
4. 셀러센터(sell.smartstore.naver.com/o/... 또는 /home)에 도달하면 Hanaro가 자동으로 NID_AUT / NID_SES / NSI / NACID 쿠키를 회수하고 모달이 닫힙니다.
5. 회수된 쿠키는 Windows DPAPI로 암호화되어 SQLite(자격증명들 테이블, 키 prefix COOKIE_)에 저장.

쿠키 만료 / 재로그인

• 네이버 세션 쿠키의 만료 주기는 약 2주입니다(네이버 정책).
• Hanaro가 자동화 호출 중 401/302 응답을 받으면 다음 동기화 사이클에서 다시 동의 다이얼로그를 띄우고 WebView2 모달을 재오픈합니다 — 사용자는 비밀번호만 다시 입력하면 됩니다.
• 자격증명 강제 재발급: 설정 → 마켓 계정 → 스마트스토어 행 → 편집 → WebView2 로그인 다시 클릭.

WebView2 Runtime 사전 요구사항

• Windows 10/11에서 Microsoft Edge WebView2 Runtime이 필요합니다.
  • Windows 11: 기본 포함되어 있습니다.
  • Windows 10: 자동 업데이트 패치로 대부분 설치되어 있으나 부재 시 설치 안내 모달이 표시됩니다.
  • 수동 설치: https://developer.microsoft.com/microsoft-edge/webview2/
• WebView2 사용자 데이터(캐시·쿠키)는 기본적으로 %APPDATA%/Hanaro/WebView2에 저장됩니다. 환경변수 HANARO_WEBVIEW2_USERDATA_FOLDER로 변경 가능.

세션 자격증명은 DPAPI로 암호화되어 SQLite에 저장됩니다. 같은 사용자/머신에서만 복호 가능.

쿠팡

1. Wing OpenAPI 신청

1. 쿠팡 Wing 로그인 후 좌측 메뉴 설정 → OPEN API 또는 직접 쿠팡 OPEN API 포털 접속.
2. API 신청 → 사용 범위 선택:
   • 주문 조회 (필수)
   • 발송 처리 (필수)
   • 반품 / 교환 (선택)
3. 승인 완료 후 VendorId, AccessKey, SecretKey 발급.

승인까지 영업일 1~3일 소요됩니다. 미리 신청해두세요.

2. Hanaro에서 등록

1. 설정 → 마켓 계정 → + 추가 → 쿠팡 선택.
2. 입력:
   • VendorId (예: A00012345)
   • AccessKey
   • SecretKey
3. 연결 테스트 → 응답 코드 200 확인 → 저장.

3. 쿠팡 특이사항

• 쿠팡은 HMAC-SHA256 서명을 모든 요청에 요구합니다 — Hanaro가 자동 처리.
• 분당 요청 제한(Rate Limit) 60회 — Polly 정책으로 자동 백오프.

카페24

1. 자체 앱 만들기

카페24는 OAuth 2.0을 사용합니다. 셀러 본인이 자체 앱을 등록하는 방식입니다.

1. 카페24 쇼핑몰 관리자 로그인 → 설정 → 앱 스토어 → 개발자 센터.
2. 자체 앱 만들기:
   • 앱 이름: Hanaro
   • 앱 설명: 주문 운영 도구
   • 권한 범위: mall.read_order, mall.write_order 체크.
   • Redirect URI: http://localhost:51234/callback (Hanaro가 자동 사용)
3. 등록 후 Client ID, Client Secret 복사.

2. Hanaro에서 등록

1. 설정 → 마켓 계정 → + 추가 → 카페24 선택.
2. 입력:
   • MallId (쇼핑몰 ID, 예: mystore — mystore.cafe24.com의 앞부분)
   • Client ID
   • Client Secret
3. OAuth 인증 시작 클릭 → 브라우저에서 카페24 로그인 → 권한 동의 → Hanaro로 리디렉트.
4. 토큰이 자동 저장됩니다 (refresh token 포함, 자동 갱신).

등록 후 확인

설정 → 마켓 계정에서 등록된 마켓 목록을 확인할 수 있습니다.

자격증명을 다시 입력하려면 편집 → 새 값 입력 → 저장. 기존 데이터는 보존됩니다.

다음

• 첫 동기화 → 온보딩에서 자동으로 시작됨 (수동: 주문 화면 F2 → [마켓에서 새 주문 받기])
• 송장 일괄 처리 → 송장 전송
• 마켓 자격증명 보안 → FAQ