使用 API 配置智能触碰

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

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

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

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

创建发卡机构帐号

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

要手动创建发卡机构帐号,请申请 Google Pay API for Passes 访问权限

分配公钥和密钥版本

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

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

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

在 REST 调用的正文中包含以下内容:

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

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

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

获取自动生成的收款方 ID

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

GET https://www.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 图标,您必须为智能触碰配置对象,并设置兑换发卡机构。要确定兑换发卡机构,请参阅确定兑换发卡机构帐号

配置对象

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

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

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