Google Pay API for Passes

有了 Google Pay API for Passes 平台，您的商家就能向數百萬名 Android 使用者展示會員卡、儲值卡、優惠、活動票券、登機證和大眾運輸票證。

只要透過這個 API 建立連結或按鈕，就能讓使用者將會員卡、儲值卡、優惠、活動票券、登機證和大眾運輸票證儲存至 Google Pay 應用程式。這些項目會儲存為物件。

注意：本說明文件將這類物件統稱為「票證」。每個物件都必須參照類別。

您可以使用這個 API 傳送鄰近地點通知、最新消息和訊息，藉此和擁有您票證的客戶互動，並讓他們輕鬆在 Google Pay 應用程式中管理票證。

一般整合程序

下圖顯示與 Google Pay API for Passes 的一般整合程序。

如要成功整合，就必須在各階段完成下列活動：

1. 技術探索
   1. 查看開發人員說明文件。
   2. 建立服務帳戶。
   3. 設計整合功能。
2. 技術整合
   1. 開發整合功能。
   2. 安排交付項目。
3. 驗證與品質確保
   1. 執行品質確保測試。
   2. 審查使用者體驗設計 (僅適用於登機證和活動票券)。
4. 發布階段
   1. 開始在不同地區推出。
   2. 開始群眾測試。
5. 正式推出
   1. 在所有地區正式上線。

建議的整合策略

Google Pay API for Passes 支援下表所列的票證類別。請參閱下表，依據票證和整合類型選擇建議的整合策略。

注意：JSON Web Token (JWT) 連結已預先插入類別，「精簡版」JWT 連結則未預先插入類別。

	會員方案	優惠	儲值卡	活動票券 (ET)	登機證 (BP)	大眾運輸票證 (TP)	團體票券 (僅限登機證、活動票券和大眾運輸票證)
網路瀏覽器	JavaScript (JS) 網站按鈕	JS 網站按鈕	JS 網站按鈕	JS 網站按鈕	JS 網站按鈕	JS 網站按鈕	JS 網站按鈕
簡訊或電子郵件	JSON Web Token (JWT) 連結	JWT 連結	JWT 連結	「精簡版」JWT 連結	「精簡版」JWT 連結	「精簡版」JWT 連結	「精簡版」JWT 連結
原生應用程式	JWT 連結	JWT 連結	JWT 連結	「精簡版」JWT 連結、JWT POST 要求方法	「精簡版」JWT 連結、JWT POST 要求方法	「精簡版」JWT 連結、JWT POST 要求方法	「精簡版」JWT 連結、JWT POST 要求方法
WebView	JWT 連結	JWT 連結	JWT 連結	JWT 連結	「精簡版」JWT 連結	「精簡版」JWT 連結	「精簡版」JWT 連結

注意：請盡量避免同時使用 WebView 和票證整合功能，並請使用者改用原生應用程式儲存票證。如果你使用的是 WebView，請實作 shouldOverrideUrlLoading 方法，讓系統重新導向至 pay.google.com。實作內容類似於以下程式碼片段：

@Override
      public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        if(request.getUrl().getHost().startsWith("pay.google.com")) {
          Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
          view.getContext().startActivity(intent);
          return true;
        }
        ...
        ...
      }

請參閱以下關於票證和 Google Pay 的資訊，瞭解你可以透過整合策略提供哪些功能。

儲存至 Google Pay

您可以將所有票證儲存至 Google Pay，方法包括使用 JavaScript 網站按鈕、透過電子郵件或簡訊，以及在 Android 應用程式中使用 JWT 連結和意圖。此外，您也可以使用原生 SDK 功能透過 Android 應用程式儲存票證，但這個方法與上述三種方法能儲存的票證並不相同，如下表所示：

	會員方案	優惠	儲值卡	活動票券	登機證	大眾運輸票證
使用原生 SDK 透過 Android 應用程式儲存票證

相關詳情請參閱將票證儲存至 Google Pay 實作詳細說明。

透過 Google Pay 兌換

所有票證都可藉由掃描出示條碼的方式及 NFC 感應功能進行兌換。相關詳情請參閱透過 Google Pay 兌換票證的實作詳細說明。

透過 Google Pay 互動

重要注意事項：在平台設定調整期間，大多數使用者都會暫時無法使用連結的優惠和設有地理圍欄的通知。我們會在即將發布的版本中更新這些功能。

所有票證均支援商家資訊區塊、自訂訊息、兌換狀態、自訂文字與圖像區塊，這些資訊可讓系統判斷使用者是否已移除票證和本地化內容。下表列出各類票證專用的功能和通知。

	會員方案	優惠	儲值卡	活動票券	登機證	大眾運輸票證
功能
範本
附帶優惠
透過 Google 助理查詢
通知
地理圍欄通知
到期通知
選取欄位更新通知
近期活動、航班或行程通知

相關詳情請參閱透過 Google Pay 與使用者互動的實作詳細說明。

如要查看各項功能在 Google Pay 應用程式中的顯示情況，請參閱會員、儲值卡、優惠、活動票券、登機證和大眾運輸票證的票證範本頁面。