如何访问 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>