本页介绍了智能触碰协议使用的标识符。
概览
智能触碰协议可传达保存到用户 Google 钱包应用和终端应用中的卡券的相关信息。下图总结了终端与 Google 钱包之间的通信流程:
由于商家可能会聘请多家商家或承包商来开发他们的卡券,因此 Google 使用三个标识符来促进 Google 钱包和终端之间的信息发送。这样,使用特定终端提供商的商家就可以兑换不同开发者提供的卡券。以下 ID 是智能触碰协议中使用的三个“集合标识符”。
兑换发卡机构 ID
兑换发卡机构 ID 是特定类型的发卡机构 ID。兑换发卡机构 ID 通常代表单个商家。相比之下,卡券开发者的发卡机构 ID 可能代表存储许多不同商家的卡券类的平台。用于存储多个商家的卡券类的平台也称为“集合商家”。
兑换发卡机构不仅仅可用于智能触碰。例如,兑换发卡机构还可用于根据兑换发卡机构的位置呈现基于地理位置的通知提醒。因此,在卡券中列为兑换发卡机构的发卡机构 ID 可能未针对智能触碰功能进行配置。
兑换发卡机构 ID 与发卡机构 ID
发卡机构 ID 是 Google 电子钱包发卡机构帐号的唯一标识符。发卡机构 ID 可在 Google Pay & Wallet Console 中找到。
发卡机构可以代表商家(例如餐厅)、优惠提供方或终端制造商等。卡券类和对象在开发出来后,会与特定发卡机构 ID 相关联。卡券类 ID 和对象 ID 中都包含发卡机构 ID。
ID | 形式 | 备注 |
---|---|---|
类 ID | issuerId.classSuffix
|
classSuffix 是开发者为特定卡券类(例如会员层级)定义的唯一值 |
对象 ID | issuerId.objectSuffix
|
objectSuffix 是开发者为特定卡券对象(例如用户 ID)定义的唯一值 |
Issuer 可以根据需要创建任意数量的类。
收款方 ID
如果商家的终端支持智能触碰,则其兑换发卡机构将获得收款方 ID。收款方 ID 是一个数字 ID(8 位数字),终端用来标识自己。由于兑换发卡机构可能支持多个商家,因此收款方 ID 用于申请特定商家的卡券。
当用户将其设备触碰支持智能触碰的终端时,终端会将收款方 ID 发送到用户的设备。然后,设备使用该收款器 ID 的公钥向终端进行身份验证。如需了解详情,请参阅通信流程。
重要提示:
- 一个发卡机构 ID 只能分配一个收款方 ID
- 收款方 ID 在所有发卡机构 ID 中都是唯一的
如需获取发卡机构 ID 的收款方 ID,请参阅商家配置。
卡券类 ID
类 ID 用于标识特定层级或卡券类型。类 ID 采用以下格式:
issuerId.classSuffix
类后缀是开发者定义且此卡券类独有的值。引用此类 ID 的卡券对象会保存到用户的 Google 钱包应用中。