如何访问 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 和状态徽章。
• 可展开的详细信息：商品（变体名称 × 数量）、收货地址以及该订单记录的任何电子邮件。
• 订单时间线：基于订单状态的逐步时间线（草稿 → 已提交 → 待处理 → 进行中 → 部分完成 → 已履约 → 已发货）。
• 查看完整订单：在您的浏览器中打开 https://whiskeymate.net/order-status.html?id=<paymentIntentId>。

幕后（订单历史 API）

• iOS 和 Android 都会通过将您的 Firebase ID 令牌作为 Authorization: Bearer ... 标头发送到 WhiskeyMate 网站的 /order-history 端点来获取您的订单历史记录。

故障排除

• 商店无法加载或无法识别您：请确保您已登录 WhiskeyMate，然后再次从应用内打开 Swag Shop，以便它传递新的令牌。
• 没有订单显示：Order Status 屏幕将显示“未找到订单”消息，并提供周边商品促销，以便您浏览产品。
• 状态更新滞后：履约/发货更新取决于供应商的处理，并且可能需要时间才能在时间线中反映出来。