WhiskeyMate Swag Shop 이용 및 주문 내역 확인 방법

<h2>개요</h2><p>WhiskeyMate의 Swag Shop은 모바일 앱에서 열 수 있는 웹 기반 스토어입니다. WhiskeyMate 앱 내에서 스토어를 열면, 앱이 현재 Firebase 로그인 토큰을 스토어로 전달하여 웹사이트에서 자동으로 로그인할 수 있도록 합니다.</p><h2>Swag Shop 열기</h2><ul> <li><strong>iOS</strong>: 메인 메뉴(컬렉션/프로필 영역에서)를 열고 <strong>Swag Shop</strong>을 탭하세요. WhiskeyMate가 Firebase ID 토큰을 가져와 브라우저에서 <code>https://whiskeymate.net/store.html?idToken=...</code>를 엽니다.</li> <li><strong>Android</strong>: 앱 메뉴를 열고 <strong>Swag Shop</strong>을 확장한 다음 <strong>Store</strong>를 선택하세요. 앱이 브라우저에서 <code>https://whiskeymate.net/store.html?idToken=...</code>를 엽니다.</li></ul><h3>자동 로그인 작동 방식 (웹)</h3><ul> <li>Swag Shop 웹사이트는 <code>idToken</code> 쿼리 매개변수를 읽고, <code>/verify-id-token</code>을 호출하여 이를 Firebase <em>커스텀 토큰</em>으로 교환한 다음, 해당 커스텀 토큰으로 로그인합니다.</li> <li>로그인 후, 웹사이트는 URL에서 <code>idToken</code>을 제거합니다 (토큰이 주소 표시줄에 남아있지 않도록).</li></ul><h2>결제 &amp; 주문 처리 (개요)</h2><ul> <li><strong>결제</strong>: Swag Shop 웹사이트에서 Stripe를 통해 결제가 처리됩니다.</li> <li><strong>주문 처리</strong>: 제품은 Printful에서 가져오며, 주문은 Printful에 제출되어 처리 및 배송됩니다. 배송 옵션은 목적지 주소에 따라 달라집니다.</li></ul><h2>주문 내역 추적 (앱 내에서)</h2><ul> <li><strong>iOS</strong>: <strong>Order History</strong>를 탭하여 앱 내 <strong>Order Status</strong> 화면을 엽니다.</li> <li><strong>Android</strong>: 메뉴 → <strong>Swag Shop</strong> → <strong>Orders</strong>를 열어 <strong>Order Status</strong>를 엽니다.</li></ul><h3>Order Status에서 볼 수 있는 내용</h3><ul> <li><strong>주문 목록</strong>: 각 주문은 날짜, 결제/의도 ID(Payment/Intent ID), 그리고 상태 배지를 보여줍니다.</li> <li><strong>확장 가능한 세부 정보</strong>: 품목 (옵션명 × 수량), 배송 주소, 해당 주문에 기록된 모든 이메일.</li> <li><strong>주문 타임라인</strong>: 주문 상태에 기반한 단계별 타임라인 (Draft → Submitted → Pending → In Progress → Partial → Fulfilled → Shipped).</li> <li><strong>전체 주문 보기</strong>: 브라우저에서 <code>https://whiskeymate.net/order-status.html?id=&lt;paymentIntentId&gt;</code>를 엽니다.</li></ul><h2>비하인드 스토리 (주문 내역 API)</h2><ul> <li>iOS와 Android 모두 Firebase ID 토큰을 <code>Authorization: Bearer ...</code> 헤더로 WhiskeyMate 사이트의 <code>/order-history</code> 엔드포인트에 전송하여 주문 내역을 가져옵니다.</li></ul><h2>문제 해결</h2><ul> <li><strong>스토어가 로드되지 않거나 사용자 인식이 안 될 때</strong>: WhiskeyMate에 로그인되어 있는지 확인한 다음, 앱 내에서 Swag Shop을 다시 열어 새로운 토큰을 전달할 수 있도록 하세요.</li> <li><strong>주문이 표시되지 않을 때</strong>: Order Status 화면에 "주문을 찾을 수 없습니다" 메시지가 표시되며, 제품을 둘러볼 수 있도록 굿즈 프로모션도 제공됩니다.</li> <li><strong>상태 업데이트가 늦다고 느껴질 때</strong>: 주문 처리/배송 업데이트는 공급업체의 처리 과정에 따라 달라지며, 타임라인에 반영되기까지 시간이 걸릴 수 있습니다.</li></ul>