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

개요

WhiskeyMate의 Swag Shop은 모바일 앱에서 열 수 있는 웹 기반 스토어입니다. WhiskeyMate 앱 내에서 스토어를 열면, 앱이 현재 Firebase 로그인 토큰을 스토어로 전달하여 웹사이트에서 자동으로 로그인할 수 있도록 합니다.

Swag Shop 열기

• iOS: 메인 메뉴(컬렉션/프로필 영역에서)를 열고 Swag Shop을 탭하세요. WhiskeyMate가 Firebase ID 토큰을 가져와 브라우저에서 https://whiskeymate.net/store.html?idToken=...를 엽니다.
• Android: 앱 메뉴를 열고 Swag Shop을 확장한 다음 Store를 선택하세요. 앱이 브라우저에서 https://whiskeymate.net/store.html?idToken=...를 엽니다.

자동 로그인 작동 방식 (웹)

• Swag Shop 웹사이트는 idToken 쿼리 매개변수를 읽고, /verify-id-token을 호출하여 이를 Firebase 커스텀 토큰으로 교환한 다음, 해당 커스텀 토큰으로 로그인합니다.
• 로그인 후, 웹사이트는 URL에서 idToken을 제거합니다 (토큰이 주소 표시줄에 남아있지 않도록).

결제 & 주문 처리 (개요)

• 결제: Swag Shop 웹사이트에서 Stripe를 통해 결제가 처리됩니다.
• 주문 처리: 제품은 Printful에서 가져오며, 주문은 Printful에 제출되어 처리 및 배송됩니다. 배송 옵션은 목적지 주소에 따라 달라집니다.

주문 내역 추적 (앱 내에서)

• iOS: Order History를 탭하여 앱 내 Order Status 화면을 엽니다.
• Android: 메뉴 → Swag Shop → Orders를 열어 Order Status를 엽니다.

Order Status에서 볼 수 있는 내용

• 주문 목록: 각 주문은 날짜, 결제/의도 ID(Payment/Intent ID), 그리고 상태 배지를 보여줍니다.
• 확장 가능한 세부 정보: 품목 (옵션명 × 수량), 배송 주소, 해당 주문에 기록된 모든 이메일.
• 주문 타임라인: 주문 상태에 기반한 단계별 타임라인 (Draft → Submitted → Pending → In Progress → Partial → Fulfilled → Shipped).
• 전체 주문 보기: 브라우저에서 https://whiskeymate.net/order-status.html?id=<paymentIntentId>를 엽니다.

비하인드 스토리 (주문 내역 API)

• iOS와 Android 모두 Firebase ID 토큰을 Authorization: Bearer ... 헤더로 WhiskeyMate 사이트의 /order-history 엔드포인트에 전송하여 주문 내역을 가져옵니다.

문제 해결

• 스토어가 로드되지 않거나 사용자 인식이 안 될 때: WhiskeyMate에 로그인되어 있는지 확인한 다음, 앱 내에서 Swag Shop을 다시 열어 새로운 토큰을 전달할 수 있도록 하세요.
• 주문이 표시되지 않을 때: Order Status 화면에 "주문을 찾을 수 없습니다" 메시지가 표시되며, 제품을 둘러볼 수 있도록 굿즈 프로모션도 제공됩니다.
• 상태 업데이트가 늦다고 느껴질 때: 주문 처리/배송 업데이트는 공급업체의 처리 과정에 따라 달라지며, 타임라인에 반영되기까지 시간이 걸릴 수 있습니다.