使用 API 配置智能触碰功能

本页介绍了如何使用 API 来配置智能触碰功能。

为智能触碰创建兑换发卡机构帐号

要创建兑换发卡机构帐号，请执行以下三个任务：

1. 创建发卡机构帐号。
2. 分配一个或多个公钥以及一个或多个密钥版本。
3. 获取自动生成的收款方 ID。

创建发卡机构帐号

要使用 API 创建发卡机构帐号，请参阅以编程方式创建发卡机构帐号。

要手动创建发卡机构帐号，请转到业务控制台。

分配一个或多个公钥以及一个或多个密钥版本

公钥及其密钥版本由终端提供商为您提供。

要分配公钥和密钥版本，请使用已获授权的服务帐号密钥对以下端点进行 REST 调用：

在 REST 调用的正文中添加以下代码：

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

响应中包含您发送的正文和一个额外字段 smartTapMerchantData.smartTapMerchantId。该字段是兑换发卡机构帐号的收款方 ID。请将收款方 ID 和其他信息一起提供给终端提供商和商家，以便为商家启用智能触碰功能。

如需详细了解如何使用发卡机构端点，请参阅 API 参考。

获取自动生成的收款方 ID

还有一种方法可以查看收款方 ID。使用授权的服务帐号密钥对以下端点进行 REST 调用：

响应中包含字段 smartTapMerchantData.smartTapMerchantId。该字段是兑换发卡机构帐号的收款方 ID。请将收款方 ID 和其他信息一起提供给终端提供商和商家，以便为商家启用智能触碰功能。

如需详细了解如何使用发卡机构端点，请参阅 API 参考。

为智能触碰兑换启用卡券

要配置类和对象以使卡券可通过智能触碰功能进行兑换，请按照本部分中的说明操作。

如果以下值和兑换发卡机构帐号均设置正确，卡券将在 Google Pay 上显示一个近距离无线通信 (NFC) 图标。只有设置了支持智能触碰的终端的商家才能通过 NFC 图标兑换卡券。

配置类

要配置类以让其对象启用 NFC，请提交一个 PATCH 请求，然后设置以下值：

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

在设置完上述类属性之后，该类下的所有对象都已启用 NFC。 要查看 NFC 图标，您必须为智能触碰配置对象，并设置兑换发卡机构。要确定兑换发卡机构，请参阅确定兑换发卡机构帐号。

配置对象

要配置对象以使其启用 NFC，请为智能触碰功能配置类。然后设置以下从卡券传送到终端的值：

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

触碰 NFC 时会传送此值。如需了解详情，请参阅从卡券传送的值。