WhiskeyMate スワッグショップへのアクセス方法と注文の追跡

概要

WhiskeyMateのスワッグショップは、モバイルアプリから開くことができるウェブベースのストアです。WhiskeyMate内からストアを開くと、アプリは現在のFirebaseサインイントークンをストアに渡し、ウェブサイトが自動的にサインインできるようにします。

スワッグショップを開く

• iOS: メインメニュー（コレクション/プロフィールエリアから）を開き、Swag Shopをタップします。WhiskeyMateはFirebase IDトークンを取得し、ブラウザでhttps://whiskeymate.net/store.html?idToken=...を開きます。
• Android: アプリメニューを開き、Swag Shopを展開し、Storeを選択します。アプリはブラウザでhttps://whiskeymate.net/store.html?idToken=...を開きます。

自動サインインの仕組み（ウェブ）

• スワッグショップのウェブサイトはidTokenクエリパラメータを読み取り、/verify-id-tokenを呼び出してFirebaseのカスタムトークンと交換し、そのカスタムトークンでサインインします。
• サインイン後、ウェブサイトはURLからidTokenを削除します（これにより、トークンがアドレスバーに残ることはありません）。

チェックアウトとフルフィルメント（概要）

• 支払い: チェックアウトはスワッグショップのウェブサイト上でStripeを介して処理されます。
• フルフィルメント: 商品はPrintfulから調達され、注文はフルフィルメントと配送のためにPrintfulに送信されます。配送オプションは、お届け先の住所によって異なります。

注文の追跡（アプリ内）

• iOS: 注文履歴をタップして、アプリ内の注文ステータス画面を開きます。
• Android: メニュー → Swag Shop → Ordersを開いて、注文ステータスを開きます。

注文ステータスで表示される内容

• 注文リスト: 各注文には、日付、支払い/インテントID、およびステータスバッジが表示されます。
• 展開可能な詳細: 商品（バリアント名 × 数量）、配送先住所、およびその注文に記録されたメールアドレス。
• 注文タイムライン: 注文ステータスに基づいた段階的なタイムライン（下書き → 送信済み → 保留中 → 処理中 → 一部完了 → 完了 → 発送済み）。
• 注文全体を表示: ブラウザでhttps://whiskeymate.net/order-status.html?id=<paymentIntentId>を開きます。

舞台裏（注文履歴API）

• iOSとAndroidの両方で、Firebase IDトークンをAuthorization: Bearer ...ヘッダーとしてWhiskeyMateサイトの/order-historyエンドポイントに送信することで、注文履歴が取得されます。

トラブルシューティング

• ストアが読み込まれない、または認識されない場合: WhiskeyMateにサインインしていることを確認し、アプリ内から再度スワッグショップを開いて、新しいトークンを渡せるようにしてください。
• 注文が表示されない場合: 注文ステータス画面には「注文が見つかりません」というメッセージが表示され、商品を閲覧できるグッズプロモーションも提供されます。
• ステータスの更新が遅れていると感じる場合: フルフィルメント/配送の更新はプロバイダーの処理に依存するため、タイムラインに反映されるまでに時間がかかる場合があります。