设置商家终端

本指南概述了如何为商家配置智能触碰功能。

设置商家终端，利用智能触碰兑换卡券

商家和终端提供商依赖卡券开发者来配置终端，从而实现智能触碰兑换功能。而卡券开发者在为商家终端设置智能触碰功能后，即可启用要在终端兑换的特定类。

要验证商家终端能否通过 NFC 兑换卡券，您必须完成以下步骤：

  • 确定为特定商家开发卡券用的发卡机构帐号。
  • 确定为智能触碰功能启用的兑换发卡机构帐号。
  • 在兑换发卡机构为智能触碰启用相应的类。

下面是需要为智能触碰设置的值：

请为兑换发卡机构帐号设置以下值：

  • 收款方 ID，在为兑换发卡机构帐号分配公钥时自动生成此值。
  • 密钥版本。
  • 公钥。

终端提供商将在商家店内的终端上设置以下值：

  • 收款方 ID。
  • 密钥版本。
  • 私钥。

在卡券上设置以下值：

  • 启用要通过智能触碰兑换的类。
  • 设置为智能触碰启用的兑换发卡机构帐号。
  • 设置要传输的值：smartTapRedemptionValue。

如需详细了解这些值，请参阅了解收款标识符。

确定包含卡券的发卡机构帐号

您必须为商家确定包含卡券的发卡机构帐号。此发卡机构帐号中将包含您为各商家开发的卡券类和对象。其中有两个选项：

  • 一个面向所有商家的中央发卡机构帐号。
  • 每个商家提供一个新的发卡机构帐号。

下面举个例子：

Foo-Loyalty 同时为 iLuvCoffee 和 teaLuv 管理各自的会员卡。您可以采用以下任一方式配置他们的卡券：

将所有类包含在一个发卡机构帐号“Foo-Loyalty”下。如果您想要跟踪类级别的卡券兑换位置，则适合选择此选项。如果您从未授予商家该发卡机构帐号的 API 访问权限，也可以选择此选项。

创建两个单独的帐号：“iLuvCoffee via Foo-Loyalty”和“teaLuv via Foo-Loyalty”。如果您想要假定某商家在特定发卡机构帐号下的类全部可兑换，或者要授予他们该发卡机构帐号的 API 访问权限，则适合选择此选项。

请参阅了解收款标识符，确定哪个选项更适合您。

如果您是负责为多个商家开发卡券的平台提供商，请联系 Google Pay API for Passes 支持部门，为新商家申请发卡机构帐号。

确定兑换发卡机构帐号

您必须确定商家的终端是否已配置为读取卡券。

可能有两种情形：

情形 1：商家已经有可兑换的卡券

如果商家确认他们已经使用自己的终端从 Google Pay 兑换卡券，请执行以下步骤：

  1. 向商家索取他们为智能触碰启用的兑换发卡机构帐号 ID。 如果商家不知道此值，请让他们联系 Google Pay API for Passes 支持部门获取该值。
  2. 在商家终端启用可兑换的卡券。有关说明，请参阅在兑换发卡机构为智能触碰启用类部分。

情形 2：商家终端支持智能触碰，但卡券没有启用智能触碰功能

如果商家终端支持智能触碰，但未用过此功能，您需要帮助商家为其终端设置智能触碰功能。

为商家启用智能触碰

请按以下步骤为商家启用智能触碰：

  1. 确定要为智能触碰启用的兑换发卡机构帐号。为此，您可以使用两种方法：
    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。

您可以启用一个类，允许多个商家使用 REST API 进行兑换。有关使用 API 配置智能触碰的更多信息，请参阅为智能触碰兑换启用卡券部分。

如需详细了解可通过 NFC 从卡券传送到终端的值，请参阅从卡券传送的值部分。