Transit イシュアからの一時停止/再開

イシュア主導の一時停止と再開は、Transit イシュア、または場合によってはユーザーが交通事業者のアプリを通じてトリガーする操作です。

このセクションでは、詳細な手順、シーケンス図、および想定されるエラーシナリオを含むワークフローの概要を説明します。

ワークフロー

一時停止 / 再開

以下は、一時停止/再開ワークフローの概要手順です:

1. 状態変更の開始: Transit イシュア、または場合によってはユーザー（交通事業者のアプリ経由）が、カードの状態変更を実行すべきであることを D1 Transit に通知します。その後、D1 Transit プラットフォームは handleTspEvent を送信して Google に通知します。
2. 状態変更の実行: イベントが Google に配信されると、D1 Transit はデジタルカードの状態変更を更新します。Google は後ほど getTokenStatus を送信し、D1 Transit から状態変更を取得して適用します。

シーケンス図

一時停止 / 再開

一時停止の場合、Transit イシュアはまずカードを拒否リストに追加する必要があります。デバイスがオフラインの場合、カードがすぐに一時停止されない可能性があるため、カードを拒否リストに追加することが重要です。

Transit イシュアは D1 Transit プラットフォームに manageDigitalCard を送信し、D1 Transit プラットフォームはさらに handleTspEvent を Google に送信します。

このリクエストを受け取ると、Google は適用する状態変更を取得し、デバイス上のデジタルカードに適用しようとします。ただし、デバイスがオフラインである可能性があるため、これはベストエフォートで行われます。

D1 Transit は、状態変更要求が Google に送信されたことを Transit イシュアに通知します。

エラーシナリオ

デバイスがオフラインです

デバイスがオフラインの場合、カード状態変更のリクエストはキューに入れられ、再接続され次第デバイスに送信されます。