Google 錢包的 Motics 票券整合步驟

本文件說明大眾運輸業者 (PTO) 及其系統整合商 (以下稱「發行者」) 在 Google 錢包中導入 Motics 時須採取的步驟。

1. 完成必要條件

  • 與 Google 簽署保密協議 (NDA)。這份線上點擊接受表單由 Google 的業務開發 (BD) 團隊提供。
  • 整合標準 Google Wallet API 以使用 QR code:
    • 核發機構會使用 Google Wallet API 佈建票證,並將票證新增至使用者的 Google 錢包應用程式。請參閱「大眾運輸 QR code」說明文件,並完成必要的整合條件,以便與 API 整合。
  • 向 VDV eTicket Service 註冊,即可取得擁有者 ID (orgId) 和 Motics 所需的相關 PKI 詳細資料。

2. 技術實作

步驟 2 包含應同時開發的主要技術實作詳細資料。

升級 Google Wallet API 實作

「技術詳細資料」頁面概略說明核發機構使用及更新 Motics 整合時所需的方法和參數。具體來說,核發機構必須使用其他 Motics 相關參數呼叫下列 Google Wallet API 方法:

實作啟用端點

Google 伺服器會呼叫發卡機構代管的啟用端點。這會觸發在核發者伺服器上產生靜態授權資料 (sigSTB)。詳情請參閱「啟用端點」一節。

為提供良好的使用者體驗,使用者應能在發卡機構定義的特定限制範圍內,將 Motics 票證從某部裝置移至另一部裝置。為此,核發機構必須實作移動並取消連結流程

儲存機票時傳送確認電子郵件

Google 會在使用者將 Motics 票證儲存至 Google 錢包時,傳送確認電子郵件給使用者。確認電子郵件 (至少) 應包含:

  • 提供實用連結,方便使用者管理票券 (訂閱)。
  • 如何與發卡機構客戶支援團隊聯絡。

3. 在 STAGING 中執行端對端整合測試

建立用於開發的 Google 錢包測試 transitClass,整合工作完成後,解決方案就需要透過此開發版本 transitClass 進行端對端測試和測試,藉此結束測試。在 transitObject:Insert 中,將 cert_environment 設為 STAGING。所有用途都應該經過全面測試,且所有測試案例都必須成功。

4. 在「正式版」中執行端對端測試

使用 STAGING 環境成功測試解決方案後,請建立新的實際工作環境 transitClass。這樣就會在插入 transitObject 時,將 cert_environment 設為 PRODUCTION。請按照「測試」一節中的所有測試案例和操作說明完成相關步驟。

5. 按照推出程序取得核准

在推出或實施公開前測前,必須獲得 Google 全面核准。核准程序取決於各種測試階段的結果及其他因素,例如 (但不限於) 下列項目必須經過 Google 審查及核准:

  • 整體推出範圍與計畫
    • 如果是前測計畫,發布計畫必須提供明確的退出條件和時程,以便全面推出。
  • 預定行銷活動
  • 啟動通訊
  • 推出日期
  • 推出當日時程和提報程序和聯絡人
  • 使用者支援程序