設定商家感應式刷卡機

本指南概略說明如何為商家設定智慧感應功能。

設定商家感應式刷卡機，以便客戶透過智慧感應功能兌換票證

如想啟用智慧感應兌換功能，商家和感應式刷卡機供應商就必須請票證開發人員設定感應式刷卡機。票證開發人員為商家的感應式刷卡機完成智慧感應功能的相關設定之後，客戶就能透過商家的感應式刷卡機兌換特定類別。

如要確認商家的感應式刷卡機能透過近距離無線通訊 (NFC) 功能兌換您的票證，請完成以下步驟：

  • 找出特定商家的票證開發專用核發機構帳戶。
  • 找出已啟用智慧感應功能的兌換核發機構帳戶。
  • 為兌換核發機構啟用要用於智慧感應功能的類別。

以下是設定智慧感應功能所需的值：

請為兌換核發機構帳戶設定以下值：

  • 賣家 ID (將公開金鑰指派給兌換核發機構帳戶時，由系統自動產生)。
  • 金鑰版本。
  • 公開金鑰。

感應式刷卡機供應商會在商家店內的感應式刷卡機上設定這些值：

  • 賣家 ID。
  • 金鑰版本。
  • 私密金鑰。

在您的票證上設定這些值：

  • 為某個類別啟用智慧感應兌換功能。
  • 設定已啟用智慧感應功能的兌換核發機構帳戶。
  • 設定要傳送的值：smartTapRedemptionValue。

如要進一步瞭解這些值，請參閱瞭解收取作業 ID 一文。

決定如何設定包含票證的核發機構帳戶

您必須決定要如何為商家設定包含票證的核發機構帳戶。這個核發機構帳戶會包含您為各個商家開發的票證類別和物件，共有兩個選項：

  • 所有商家共用一個集中式核發機構帳戶。
  • 讓每個商家擁有一個新的核發機構帳戶。

請見以下範例：

Foo-Loyalty 分別為 iLuvCoffee 和 teaLuv 管理會員方案。您可以使用下列其中一種方式為他們設定票證：

將所有類別納入同一個核發機構帳戶「Foo-Loyalty」。如要在類別層級追蹤可兌換票證的位置，建議您採用這個選項。如果您從未授予商家其核發機構帳戶的 API 存取權，也很適合選擇這個方式。

建立兩個獨立帳戶：「透過 Foo-Loyalty 兌換 iLuvCoffee」和「透過 Foo-Loyalty 兌換 teaLuv」。如想允許特定商家兌換某個核發機構帳戶下的所有類別，或是需要授予核發機構帳戶的 API 存取權給該商家，建議您採用這個選項。

如要評估哪個選項最適合您，請參閱瞭解收取作業 ID 一文。

如果您是為多個商家開發票證的平台供應商，請與 Google Pay API for Passes 支援團隊聯絡，為新的商家提出核發機構帳戶要求。

判斷兌換核發機構是否可讀取票證

您必須確認商家的感應式刷卡機設定正確無誤，可以讀取您的票證。

共有兩種可能的情境：

情境 1：商家已有可兌換的票證

如果商家確定已可透過感應式刷卡機兌換 Google Pay 票證，請按照以下步驟操作：

  1. 要求商家提供已啟用智慧感應功能的兌換核發機構帳戶 ID：如果商家不知道這個 ID，請他們與 Google Pay API for Passes 支援小組聯絡以取得該資訊。
  2. 在商家的感應式刷卡機上啟用您的可兌換票證。如需操作說明，請參閱為兌換核發機構啟用類別的智慧感應功能一節。

情境 2：商家的感應式刷卡機支援智慧感應功能，但尚未啟用任何票證的智慧感應功能

如果商家的感應式刷卡機支援智慧感應功能，但這項功能仍未啟用，則您必須協助商家設定感應式刷卡機的智慧感應功能。

為商家啟用智慧感應功能

如要為商家啟用智慧感應功能，請按照下列步驟操作：

  1. 找出要啟用智慧感應功能的兌換核發機構帳戶，您有 2 種做法：
    1. 代表商家建立帳戶。請注意，新核發機構的帳戶聯絡資訊中必須包含該商家的相關資訊。
      1. 使用表單：申請取得 Google Pay API for Passes 的存取權。
      2. 使用 REST API：請參閱建立核發機構帳戶的相關說明。
    2. 確認你是否能重複使用含有已開發票證的帳戶。
      1. 如果您的票證開發專用核發機構帳戶中含有適用於不同商家的類別，您必須代該商家設定新的帳戶。如要設定新的帳戶，請採用上述的其中一種方式。這個帳戶即為「兌換核發機構帳戶」。
      2. 如果您的票證開發專用核發機構帳戶僅包含適用於該特定商家的類別，請指定帳戶做為兌換核發機構帳戶，您不需要申請新的帳戶。
  2. 向感應式刷卡機供應商索取公開金鑰和金鑰版本。
    1. 如果感應式刷卡機供應商要求您先提供賣家 ID，請按照步驟 3 的指示產生賣家 ID。
  3. 使用 API 為兌換核發機構指派公開金鑰和金鑰版本。
    1. 您可以透過這項程序為兌換核發機構指派一組賣家 ID。
    2. 如要確認賣家 ID，請參閱取得系統自動產生的賣家 ID一節。
  4. 將你在步驟 3 中設定的賣家 ID 提供給感應式刷卡機供應商。
  5. 將以下資訊提供給商家：
    1. 您在步驟 1 中取得的兌換核發機構 ID，以及連至 Google Pay API for Passes Merchant Center 帳戶的連結。
    2. 您在步驟 3 中取得的賣家 ID。
    3. 向商家說明必須永久保存兌換核發機構帳戶 ID 和賣家 ID。商家必須提供兌換核發機構帳戶 ID 給任何需要為類別啟用智慧感應兌換功能的票證開發人員。

只要取得兌換核發機構帳戶 ID，任何票證開發人員都能對應類別，使類別可透過智慧感應功能兌換。

為兌換核發機構啟用類別的智慧感應功能

一個類別可透過多個商家兌換。舉例來說，某個類別代表了特定的會員方案，該會員方案可能同時適用於多個商家。在這個情況下，單一類別會獲派多組兌換核發機構帳戶 ID，這些 ID 都代表不同的商家。

您可以透過 REST API 進行設定，允許多個商家兌換同一個類別。如要進一步瞭解如何透過 API 設定智慧感應功能，請參閱為票證啟用智慧感應兌換功能一節。

如要進一步瞭解哪些內容會透過 NFC 功能從票證傳輸至感應式刷卡機，請參閱從票證傳出的值一節。