使用 API 設定智慧感應功能

本頁面說明如何使用 API 設定智慧感應功能。

為智慧感應功能建立兌換核發機構帳戶

如要建立兌換核發機構帳戶，請執行以下三項工作：

  1. 建立核發機構帳戶。
  2. 指派一或多個公開金鑰和一或多個金鑰版本。
  3. 取得系統自動產生的賣家 ID。

建立核發機構帳戶

如要透過 API 建立核發機構帳戶，請參閱透過程式建立核發機構帳戶一文。

如要手動建立核發機構帳戶，請前往商家主控台。

指派一或多個公開金鑰和一或多個金鑰版本

感應式刷卡機供應商會將公開金鑰和其金鑰版本提供給你。

如要指派公開金鑰和金鑰版本，請使用授權服務帳戶金鑰向以下端點傳送 REST 呼叫：

PATCH https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

在 REST 呼叫的內容中加入以下內容：

{
  "smartTapMerchantData": {
    "authenticationKeys": [{
        "id": 1,
        "publicKeyPem": "<my_public_key>"
      },
      {
        "id": 2,
        "publicKeyPem": "..."
      }
    ]
  }
}

回應中會包含您傳送的內容和一個額外的欄位：smartTapMerchantData.smartTapMerchantId。這是兌換核發機構帳戶的賣家 ID。將賣家 ID 和其他資訊提供給感應式刷卡機供應商和商家，以便為商家啟用智慧感應功能。

如要進一步瞭解如何使用核發機構端點，請參閱 API 參考資料。

取得系統自動產生的賣家 ID

您可以透過另一種方式查看賣家 ID，那就是使用授權服務帳戶金鑰向以下端點傳送 REST 呼叫：

GET https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

回應中會包含 smartTapMerchantData.smartTapMerchantId 欄位，這是兌換核發機構帳戶的賣家 ID。將賣家 ID 和其他資訊提供給感應式刷卡機供應商和商家，以便為商家啟用智慧感應功能。

如要進一步瞭解如何使用核發機構端點，請參閱 API 參考資料。

為票證啟用智慧感應兌換功能

如要設定類別和物件，以便客戶透過智慧感應功能兌換票證，請按照本節指示操作。

下列值和兌換票證發卡機構帳戶均正確設定完畢後，Google Pay 中的票證就會顯示「近距離無線通訊」(NFC) 圖示。如果商家想要兌換標有 NFC 圖示的票證，就必須設定支援智慧感應功能的感應式刷卡機。

設定類別

如要設定類別來啟用當中物件的 NFC 功能，請提出修補要求並設定下列值：

  class.enableSmartTap = true
  class.redemptionIssuers[] = ["issuer_id_1",... ,"issuer_id_n"]

上述類別屬性設定完成後，這個類別中的所有物件都會支援 NFC 功能。您必須先為物件進行智慧感應功能的相關設定，並設定兌換核發機構，系統才會顯示 NFC 圖示。如要判斷兌換核發機構是否可讀取票證，請參閱判斷兌換核發機構是否可讀取票證的相關說明。

設定物件

如要設定物件，使物件支援 NFC 功能，請為類別進行智慧感應功能的相關設定，然後設定下列從票證傳輸至感應式刷卡機的值：

  object.smartTapRedemptionValue = "string value to be conveyed over NFC"

這個值即為系統在 NFC 功能發揮作用時傳輸的值，詳情請參閱從票證傳出的值一節。