> For the complete documentation index, see [llms.txt](https://guide.hypercape.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guide.hypercape.com/brand-guide/undefined/undefined.md).
# 자사몰 연결
이 파트는 **처음 자사몰을 붙이는 한 번의 흐름**입니다. 한 번 끝내면 다시 볼 일이 거의 없으며, 그 뒤로는 Part 2 이후의 운영 화면을 사용하시게 됩니다.
### 1. 몰 운영 페이지 첫 방문
좌측 메뉴 **몰 운영 > 쇼핑몰 목록** 을 클릭합니다. 페이지 상단에 큰 글씨로 **몰 운영** 이 보이고, 그 바로 아래 **추천 작업** 카드가 나타납니다.
처음 진입 시에는 추천 작업 카드에 **첫 연결** 배지와 함께 "**첫 몰을 연결하면 됩니다**" 라는 제목이 떠 있습니다.
> **추천 작업의 5가지 상태** 페이지를 매번 열 때마다 시스템이 그 시점에 가장 우선해야 할 작업을 자동으로 골라 줍니다.
>
> * **첫 연결** — 아직 연결된 몰이 없을 때
> * **복구 우선** — 막힌 몰이 있을 때 (가장 먼저 풀어야 함)
> * **준비 이어가기** — 연결은 됐지만 상품 준비가 끝나지 않았을 때
> * **운영 이어가기** — 준비 끝, 바로 운영 가능
> * **이벤트 먼저 가능** — 몰 없이 이벤트만 운영해도 되는 상태
### 2. 새 쇼핑몰 연결하기 카드
페이지를 아래로 내리면 **새 쇼핑몰 연결하기** 카드가 있습니다. 이미 연결된 몰이 있는 분은 **다른 쇼핑몰 추가 연동** 으로 제목이 바뀌어 있을 수 있습니다. 카드 우측에는 "보통 30초면 끝나요" 라는 작은 안내가 함께 떠 있습니다.
#### 2-1. 입력란 두 개 (둘 다 선택사항)
1. **쇼핑몰 구분 이름 — 선택**
* 목록에서 알아보기 쉬운 별명
* 예: "북미 공식몰", "셀리맥스 일본몰"
* 고객에게는 보이지 않습니다.
2. **쇼핑몰 주소 — 선택**
* 실제 오픈한 사이트 주소 (예: `https://shop.example.com`)
* 적어 두면 목록에 **스토어 열기** 링크가 자동으로 달리고, **연동 확인** 도 더 정확하게 동작합니다.
> 둘 다 비워둔 채로 진행해도 됩니다. 다만 나중에 몰이 여러 개로 늘어났을 때 알아보기 위해 채워 두시는 것을 권장합니다.
#### 2-2. 관리자(Admin)에서 이미 만들었나요?
입력란 위쪽에 접혀 있는 **관리자(Admin)에서 이미 몰을 만드셨나요?** 영역이 있습니다. 다른 화면에서 이미 같은 브랜드의 몰을 만든 적이 있다면 펼쳐서 안내를 확인해 주세요. **여기서 또 만들면 카드가 중복되어 헷갈립니다.**
### 3. 연결 비밀번호 받기 — 정보 발급
오른쪽 아래의 큰 버튼을 누릅니다.
* 처음 연결: **연결 비밀번호 받기**
* 추가 연결: **추가 연동 정보 발급받기**
버튼을 누르면 잠시 후 화면 가운데에 큰 팝업이 열립니다. 제목은 **복사만 하면 끝이에요** 입니다.
> 🔴 **이 팝업이 비밀번호를 보여주는 처음이자 마지막 화면입니다.** 창을 닫으면 같은 비밀번호를 다시 볼 수 없으므로, 닫기 전에 반드시 복사를 마쳐 주세요.
#### 3-1. 한 번에 복사하기 (가장 안전)
팝업 맨 위 큰 파란 버튼 **모든 설정 한 번에 복사** 를 누르면 4가지 정보가 한꺼번에 클립보드에 담깁니다. 자사몰 개발자에게 전달할 때 이 방법을 가장 추천드립니다. 복사가 끝나면 버튼이 **복사 완료** 로 잠시 바뀝니다.
#### 3-2. 항목별로 복사하기
큰 버튼 아래에 5가지 항목 카드가 있습니다. 한 줄씩만 복사할 때 사용합니다.
| 보이는 이름 | 개발자가 보는 이름 | 어디에 쓰이나요? |
| --------------- | ------------------------------- | -------------------------- |
| **브랜드 서버 주소** | `KANGAROO_BRAND_API_URL` | 자사몰이 우리 브랜드 시스템에 연락할 주소 |
| **자동 생성된 연결 키** | `KANGAROO_STOREFRONT_CLIENT_ID` | 자사몰 식별 번호 (열쇠의 "번호") |
| **연결용 비밀번호** | `KANGAROO_STOREFRONT_SECRET` | 자사몰만 알아야 할 비밀 (열쇠의 "비밀번호") |
| **브랜드 고유 번호** | `KANGAROO_ADMIN_BRAND_ID` | 시스템이 어느 브랜드인지 구분 |
| **쇼핑몰 등록 번호** | 내부 ID | 문의·지원 시에만 사용 (런타임에는 불필요) |
#### 3-3. 자사몰 개발자에게 안전하게 전달하기
**해도 되는 것**
* 사내 비밀 저장소(예: 1Password, Bitwarden)에 붙여넣고 개발자에게 항목 공유
* 개발자가 옆에 있을 때 그 자리에서 화면을 보여주며 옮기기
**절대 하면 안 되는 것**
* 카카오톡, 일반 슬랙, 이메일 본문에 비밀번호를 그대로 붙여넣기
* 사내 위키, 노션 페이지에 평문 저장
* 외주사·신뢰 미확인 외부 채널로 전송
비밀번호는 **집의 비밀번호와 같습니다**. 한 번 새는 순간 누구든 자사몰처럼 우리 서버에 접속할 수 있습니다.
### 4. 자사몰에 적용된 뒤 — 연동 확인
자사몰 개발자가 정보 4개를 적용하고 자사몰 서버를 다시 켰다고 알려주면, 우리 화면에서 통신을 점검합니다.
1. **몰 운영** 페이지의 **몰 디렉토리** 섹션으로 돌아갑니다.
2. 방금 만든 몰 카드를 찾습니다 (가장 위에 **추천** 배지가 붙어 있을 가능성이 높습니다).
3. 카드 아래쪽 **보조 관리 작업** 영역에서 **연동 확인** 버튼을 누릅니다.
성공하면 "**연동이 확인됐어요**" 안내가 잠시 뜨고, "마지막 확인" 시각이 갱신됩니다.
### 5. 이 몰로 이동 — 운영 시작
연동 확인이 끝나면 카드의 큰 버튼 **이 몰로 이동** 을 누릅니다. 이 버튼이 운영의 입구입니다. 누르는 순간 그 몰만의 작업 공간 — **몰 워크스페이스** — 으로 들어갑니다.
여기까지가 **첫 연결**입니다. 다음 파트부터는 일상 운영 화면입니다.