使用 API 配置智能触碰功能

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

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

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

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

创建发卡机构帐号

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

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

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

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

要点：如果终端提供商在您提供收款方 ID 前没有提供公钥，请先使用下面的演示密钥：

-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj86
9zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==
\n-----END PUBLIC KEY-----\n
    

首次设置公钥时，系统会为兑换发卡机构帐号生成一个唯一的收款方 ID。

从终端提供商处获取实际的公钥后，务必移除此演示密钥。

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

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

重要提示：smartTapMerchantData.authenticationKeys[].id 必须为小数。范围介于 1 到 2147483647（含）之间。每个公钥都需要具备唯一的密钥版本。

注意：请使用与创建此发卡机构帐号的用户帐号相关联的授权服务帐号密钥。

在 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，请提交一个 PATCH 请求，然后设置以下值：

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

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

警告：如果您在 REST API 中使用了 update() 类，请务必先调用 get() 方法，然后再执行更新。否则这些属性可能会被清空或错误地设置。或者，您也可以使用 patch()。

配置对象

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

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

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

警告：如果您在 REST API 中使用了 update() 类，请务必先调用 get() 方法，然后再执行更新。否则这些属性可能会被清空或错误地设置。或者，您也可以使用 patch()。