如何存取 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 和狀態徽章。</li> <li><strong>可展開的詳細資訊</strong>: 商品（變體名稱 × 數量）、運送地址，以及該訂單記錄的任何電子郵件。</li> <li><strong>訂單時間軸</strong>: 基於訂單狀態的逐步時間軸（草稿 → 已提交 → 待處理 → 處理中 → 部分完成 → 已完成 → 已出貨）。</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>