Google Wallet API 常见问题解答

使用入门

什么是 Google Wallet API？

借助 Google Wallet API，开发者可以在 Google 钱包中创建数字卡券。Google Wallet API 目前支持登机牌、活动门票、会员卡、优惠和公交卡。最近，添加了一个通用卡券类型，以支持更多用例。

如何根据业务要求和复杂性设置开发环境？

下面的指南可用于设置适合不同业务复杂性和安全性级别的开发环境。使用多个服务帐号可让开发者创建独立于其 PROD 环境的测试环境。

基本设置复杂性

1 个企业控制台账号或 1 个企业控制台父账号关联到多个发卡机构账号。

  • 此选项支持使用 1 个主账号以及零到多个子企业/颁发者进行集中管理。
  • 1 个 Google Cloud 项目。
  • 1 个服务帐号凭据。
  • 一组用户。

平均设置复杂程度

多个发卡机构帐号关联 1 个父级帐号。

  • 选择此选项可以采用集中管理的方式，只需使用 1 个主账号和多个子商家即可实施。
  • 1 个 Google Cloud 项目。
  • 每个颁发者的不同业务控制台用户。
  • 1 到多个服务帐号凭据。
    • 每个商家/颁发者 1 个凭据。
    • 每个商家拥有不同的凭据访问权限。

设置复杂

多个发卡机构帐号关联 1 个父级帐号。

  • 选择此选项可以采用集中管理的方式，只需使用 1 个主账号和多个子商家即可实施。
  • 一到多个 Google Cloud 项目。
  • 每个颁发者的不同业务控制台用户。
  • 1 到多个服务帐号凭据。
    • 每个商家/颁发者可获取 1 个 PROD 凭证。
    • 每个商家/颁发者需要 1 个 DEV 凭据。

与支持团队联系

使用卡券

如何删除类或对象？

目前，您无法从 Google 钱包中删除类或对象。不过，用户可以从 Google 钱包中解除关联对象。

如何将多张卡券归为一组？

使用 GroupingID 可以轻松地将卡券分组。

如何仅更新卡券的部分内容？

请参阅我们的性能指南，了解如何使用 PATCH 请求执行部分更新。

我可以批量创建卡券吗？

请参阅我们的性能指南，了解如何使用 API 执行批量请求。

常见问题

向 Google Wallet API 发送请求的速率限制是多少？

调用 Google Wallet API 的速率限制为每秒 20 次请求。

Google Wallet API 会返回哪些错误代码？

如需查看 Google Wallet API 返回的错误代码和异常列表，请参阅错误代码。

如何启用推送通知？

Google 钱包目前不支持开发者编写的推送通知。 不过，Google 钱包会及时针对以下卡券发出通知。 Google 钱包目前不支持开发者编写的推送通知。

垂直 通知 已触发 文档
事件 即将显示的提醒 活动开始前 3 小时 docs
登机牌 即将显示的提醒 航班起飞前 3 小时 docs
登机牌 卡券更新 出发地航站楼、登机口、登机时间或出发时间变更 docs
优惠卡片 到期提醒 优惠卡片到期前 48 小时 docs
通用 即将显示的提醒 “时间间隔”开始前 24 小时 docs
通用 到期提醒 “内部时间”结束前 48 小时 docs

可以删除商家 ID 吗？

目前，无法从 Google Pay & Wallet Console 删除或归档商家 ID。

如何使用 Applinking 功能？

应用关联需要列入许可名单，可以在此处申请。

Google 钱包是否支持地理围栏？

目前不支持地理围栏。

如何设置会员回馈活动？

您可以按照此指南设置注册和会员回馈活动。

如何向 Google 发送公交卡徽标？

请使用此表单将徽标发送给 Google，以便列入许可名单。

如何正确处理 Base64 编码的 userProfile 数据？

请确保在整个过程中都使用 UTF-8 编码。JSON 字符串会先进行 UTF-8 编码，然后使用 android.util.Base64（包含 NO_WRAP 和 网址_SAFE 选项）进行编码。 这与 RFC 3548 第 4 节相对应。

如何以编程方式创建发卡机构帐号？

请参阅此指南，通过 API 创建发卡机构帐号。

智能触碰

我需要安装特殊的 NFC 读取器才能读取 Google SmartTap 卡券吗？

它必须是支持 SmartTap 的终端。如需查看经过认证的提供商列表，请点击此处。

如何让卡券支持 NFC？

请按照此配置操作，让您的卡券可通过智能触碰兑换。

JSON 网络令牌 (JWT)

是否有可以简化 JWT 实现和调试的工具？

是的，诸如 www.jwt.io 之类的平台允许您在开发过程中解码和调试令牌，从而验证您要提交的内容。请注意，Google 没有任何关联，也不会特别推荐任何此类第三方。

您可以在创建保存卡券链接 (JWT) 之前使用 API 预先创建类和对象 。

问题排查

为什么我的时间设置显示的活动时间不正确？

卡券上显示的时间是事件所在地的当地时间，包含事件发生时间的偏移量。

我的徽标无法显示在我构建的卡券上。哪里可能出了问题？

  • 首先，请确保您的徽标遵循相关准则，并以 PNG 格式保存。
  • 确保徽标易于使用且可靠性高。请勿重定向到可能导致 404 错误的图片文件。您的图片应托管在 HTTPS 位置，否则将无法在 Google 钱包中看到。
  • 确保在卡券中设置了 API 中标记为必需的所有必填字段。

支持与反馈

如何与技术支持人员联系？

如需其他帮助，请点击 Google Pay 和钱包控制台左侧边栏中的“与支持团队联系”按钮，与支持团队联系。

如何提供产品反馈？

如需提交产品反馈，请点击开发者网站页面右上角象限中的“发送反馈”按钮，然后选择“产品反馈”。接下来，在文本区域描述您的反馈，然后点击“发送”。

如何提供文档反馈？

如需提供文档反馈，请点击开发者网站页面右上角象限中的“发送反馈”按钮，然后选择“文档反馈”。接下来，在文本区域描述您的反馈，然后点击“发送”。