设置商家终端

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

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

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

要验证商家终端能否通过 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. 在商家终端启用可兑换的卡券。有关说明,请参阅使用兑换发卡机构 ID 为类启用智能触碰兑换部分。

情形 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 从卡券传送到终端的值,请参阅从 Google Pay 中的卡券传送到终端的值部分。