자사몰 연결

이 파트는 처음 자사몰을 붙이는 한 번의 흐름입니다. 한 번 끝내면 다시 볼 일이 거의 없으며, 그 뒤로는 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. 이 몰로 이동 — 운영 시작

연동 확인이 끝나면 카드의 큰 버튼 이 몰로 이동 을 누릅니다. 이 버튼이 운영의 입구입니다. 누르는 순간 그 몰만의 작업 공간 — 몰 워크스페이스 — 으로 들어갑니다.

여기까지가 첫 연결입니다. 다음 파트부터는 일상 운영 화면입니다.