Transit アプリのプロビジョニング後の運賃プロダクト購入

Transit Appの事後プロビジョニング運賃商品購入ワークフローは、トランジット事業者のアプリを通じてユーザーが直接開始します。主な目的は、ユーザーがアプリ内で運賃商品を購入し、それがシームレスにGoogle Walletのトランジットカードに適用されて即時に使用できるようにすることです。

ワークフロー

以下の上位レベルの手順は、Transit Appの事後プロビジョニング運賃商品購入ワークフローの概要を示しています：

1. 運賃商品の選択と支払い：ユーザーはトランジット事業者のアプリから購入したい運賃商品を選択します。既存の残高にストアドバリューを追加することや、運賃商品の購入／更新が含まれる場合があります。
2. メタデータ取得とウォレット表示の更新：metadataUpdatedリクエストを受信すると、GoogleはD1 Transitから更新されたカードメタデータを要求します。。

運賃商品の選択と支払い

ワークフローが開始される前に、ユーザーはトランジット事業者のアプリ内で彼のトランジットカードに追加する有効性のある運賃商品を選択する必要があります。

運賃商品が選択されると、アプリは購入を完了するための支払いオプションを表示する必要があります。ユーザーは利用可能なオプションから希望の支払方法を選択できます。

エラーシナリオ

購入または更新が許可されていない

ビジネスルール（例：カードの有効期限切れや対象外の運賃商品）により運賃商品の購入または更新が禁止されている場合、トランジット事業者のアプリはそれをユーザーに示すものとします。

メタデータ取得とウォレット表示の更新

運賃商品を正常に購入または更新した後、Transit イシュアはhandleEventをD1 Transitに送信し、D1 TransitはallProductMetadataUpdated APIリクエストでGoogleに通知します。

allProductMetadataUpdatedリクエストを受信すると、GoogleはgetAllProductMetadataリクエストをD1 Transitに行い、商品メタデータを取得します。