本文件說明大眾運輸業者 (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 審查及核准:
- 整體推出範圍與計畫
- 如果是前測計畫,發布計畫必須提供明確的退出條件和時程,以便全面推出。
- 預定行銷活動
- 啟動通訊
- 推出日期
- 推出當日時程和提報程序和聯絡人
- 使用者支援程序