自动关联的卡券

背景

借助“自动关联的卡券”功能,您可以将更多卡券发送到 且已在 Google 钱包中存储您的现有卡券的用户。您还可以 当用户保存主要卡券时,预链接会传递给主卡券 (主)通过。自动链接卡券与主卡券组合在一起,其 主卡券上方的标注,告知用户有新的卡券 已关联。以下卡券类型受支持作为主卡券或关联卡券:

  • 活动门票
  • 登机牌
  • 公交卡
  • 优惠
  • 礼品卡
  • 会员卡
  • 通用通行证
。 <ph type="x-smartling-placeholder">
自动关联卡券的主要示例 自动链接卡券次要示例
带有“已添加新卡券”标注的主卡券 已关联到主卡券的新卡券

使用场景

将卡券关联到现有卡券可能有不同的用例。以下是一些示例:

  • 将优惠与现有会员卡相关联。
  • 将餐券与登机牌或活动门票相关联。
  • 将停车卡关联到活动门票。

使用自动关联的卡券时的一些注意事项

  • 主要对象和链接对象必须使用相同的 publisherId。
  • 每个主要对象最多只能有 50 个关联的对象。
  • 我们无法保证自动推送关联的卡券,也无法保证 尽力而为。用户可以选择停止接收自动关联的卡券。如果用例是 关键,且用户必须收到关联的卡券,我们建议 通过另一渠道进行通信,以确保用户添加卡券。
  • Google 电子钱包 AUP 更新 包含使用自动关联的卡券时应遵循的指南。

集成步骤

如果您已创建主要对象,则可以跳过第 1 步。

  1. 创建列出的任何卡券类型的对象 包含必需参数。这是主要对象。
  2. 创建另一个具有任意所列卡券类型的对象。这将是 linked 对象中。
  3. 在主要对象保存之前或之后,执行 update 具有 linkedObjectIds 中关联对象的 ID 的主要对象 参数。

在主实例上设置 linkedObjectId 需要最低载荷 。这 3 个必需参数包括:

  1. ISSUERID.PRIMARY_OBJECT_ID
  2. ISSUERID.PRIMARY_CLASS_ID
  3. ISSUERID.LINKED_OBJECT_ID

将链接对象添加到卡券对象的 JSON 请求示例

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"}
  }
  …

将对象关联到卡券对象后的 JSON 响应示例

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

预期行为

收到成功响应后,已更新卡券的设备 应该可以收到关联的卡券。此关联的卡券将与 主要测试环节。用户可以通过向右滑动来查看关联的卡券。

异常处理

错误使用 API 可能会导致潜在错误 包含;

短信 原因
主要对象和关联对象不共用同一发卡机构 ID。 您无法将链接的对象附加到其他发卡机构的对象。
主要对象和链接对象引用同一个对象。 您不能附加与 linkedObject 相同的对象。
关联的对象不存在。 链接的对象应已插入钱包 API。
关联的对象已有一个关联的对象。无法添加嵌套项 链接的对象。 所关联对象不能包含其他关联对象。
此对象已与其他对象关联。无法添加嵌套链接 对象的操作。 主要对象本身不能是链接对象。
已超出上限,无法再添加更多关联对象。 已达到主账号关联的卡券数量上限(50 个) 。