FAQ / トラブルシュート

パス・ウォレット

Apple Wallet にパスが追加されない

症状：「Apple Wallet に追加」リンクを開いたが、ウォレットアプリが起動しない、またはエラーが表示される。

確認事項：

• iOS デバイスで操作しているか確認してください（Android / PCでは .pkpass を開けません）
• iOS の「ウォレットと Apple Pay」設定が有効になっているか確認してください
• Safari 以外のブラウザを使用している場合は Safari で試してください

---

Google Wallet にパスが保存されない

症状：「Save to Google Wallet」ボタンを押したが何も起きない。

確認事項：

• Android デバイスで操作しているか確認してください
• Google ウォレットアプリがインストール・ログイン済みか確認してください
• Googleアカウントの国・地域設定を確認してください（一部地域では Google Wallet が利用不可）

---

パスをウォレットに追加した後に情報が古いまま

症状：パスの内容を変更したが、ウォレットアプリに反映されない。

説明：現在のMVP では Apple PassKit Web Service（動的更新・プッシュ通知）は対応していません。変更後のパスを再発行して、新しい配布リンクを案内してください。

---

QRコード検証

キオスクでQRが読み取れない

症状：QRをかざしてもスキャンできない。

確認事項：

• カメラとQRコードの距離・角度を調整してください（通常10〜30cm）
• 画面の明るさを最大にしてください（デジタルパスをスキャンする場合）
• QR印刷が鮮明か確認してください（紙チケットの場合）
• アプリのカメラ権限が許可されているか確認してください

---

QRを読み取ったが「無効」と表示される

症状：スキャンは成功したが、結果が赤（無効）になる。

主な原因：

• 取消済み（revoked）：管理画面でパスが取り消されています。発行者に確認してください
• 有効期限切れ（expired）：パスの有効期限が過ぎています
• 署名不正：QRが正規のPASTAで発行されたものではない可能性があります
• 別テナントのQR：このキオスクが設定されているテナントとは異なるテナントのパスです

---

「使用済み」と表示されるが、本人は初めて使う

症状：正規のユーザーなのに already_redeemed（使用済み）となる。

確認事項：

• オフライン環境で複数の端末が同一パスをスキャンした可能性があります（オフライン検証の制限を参照）
• 同じパスが別の経路（APIや他のキオスク）で検証された可能性があります
• 設定画面の「同期ログ」で矛盾が記録されていないか確認してください

---

キオスク・同期

オフライン償却キューが同期されない

症状：オンラインに復帰したが、オフライン中の償却が送信されない。

対処法：

1. 設定画面の「今すぐ同期」ボタンをタップします
2. それでも解決しない場合は、アプリを再起動してください
3. 未同期件数が設定画面に「0」と表示されるまで確認してください

---

キオスク設定QRを紛失した（再表示できない）

説明：設定QRは一度しか表示されません（APIキーの生の値を含むため）。

対処法：

1. 管理画面の「APIキー」から、該当するAPIキーを失効させます
2. 「キオスク設定QRを発行」から新しいQRを発行します
3. 端末を再プロビジョニングします

---

管理画面にログインできない（複数テナント）

症状：パスワードを入力しても「テナントを選択してください」という画面が出る。

説明：これは正常な動作です。同一メールアドレスで複数のテナントに所属している場合、ログイン後にテナント選択画面が表示されます。アクセスしたいテナントを選択してください。

---

その他

Stripe決済はいつ対応しますか？

Stripe Terminal 連携（決済→その場でパス発行）は今後対応予定です。現在のMVPには含まれません。

SAML / OIDC でのシングルサインオンはいつ対応しますか？

SAML / OIDC によるシングルサインオンは今後対応予定です。現在のMVPはメールアドレス＋パスワード認証のみです。