Google Wallet API 常见问题解答

使用入门

什么是 Google Wallet API?

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

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

以下指南可用于设置开发环境,以满足不同级别的业务复杂性和安全性要求。使用多个服务账号可让开发者创建与其 PROD 环境分离的 TEST 环境。

基本设置复杂性

1 个商家控制台账号或 1 个商家控制台父级账号与多个发卡机构账号相关联。

  • 此选项支持使用 1 个主账号(包含零个或多个子公司/发卡机构)进行集中管理。
  • 1 个 Google Cloud 项目。
  • 1 个服务账号凭据。
  • 一组用户。

平均设置复杂性

多个发卡机构账号对应 1 个父级账号。

  • 此选项支持使用 1 个包含多个子商家的主账号采用集中管理方式。
  • 1 个 Google Cloud 项目。
  • 每个发卡机构的独特商家控制台用户数。
  • 1 对多服务账号凭据。
    • 每个商家/发卡机构 1 个凭据。
    • 每个商家都有不同的凭据访问权限。

复杂的设置

1 个父级账号对应多个发卡账号。

  • 通过此选项,您可以使用 1 个主账号以及多个子业务进行集中管理。
  • 1 到多个 Google Cloud 项目。
  • 每个发卡机构的独特商家控制台用户数。
  • 1 对多服务账号凭据。
    • 每个商家/签发机构 1 个 PROD 凭据。
    • 每个商家/签发机构 1 个 DEV 凭据。

与支持团队联系

使用卡券

如何删除类或对象?

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

如何将多个卡券归为一组?

使用 GroupingID 可以轻松地将卡券归为一组。

如何仅更新卡券的一部分?

请按照我们的效果指南了解如何使用 PATCH 请求执行部分更新。

我可以批量创建卡券吗?

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

常规问题

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

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

为什么 Google 钱包的卡券中不得使用个人图片?

Google 钱包不支持在卡券上添加个人图片,因为现行法规规定,所有消费者都有权选择停止收集或处理敏感数据。如果将敏感数据(个人图片)作为有价值对象的一部分(在 JWT 中),可能会出现托管问题,即数据可能会公开,而这超出了原始意见征求协议的范围。为了确保数据的机密性,不允许使用个人图片。我们正在努力,以期在未来支持个人图片。

Google 钱包 API 会返回哪些错误代码?

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

如何启用推送通知?

Google 钱包目前不支持开发者撰写的推送通知。 不过,Google 钱包会及时为以下卡券提供通知。 Google 钱包目前不支持开发者编写的推送通知。

纵向 通知 已触发 文档
事件 即将显示的提醒 比活动当天提前 3 小时 文档
登机牌 即将显示的提醒 航班起飞前 3 小时 文档
登机牌 卡券更新 出发地航站楼、登机口、登机时间或出发时间发生变化 文档
优惠卡 到期提醒 优惠卡到期前 48 小时 文档
Generic 即将显示的提醒 在“时间间隔”开始前 24 小时 文档
Generic 到期提醒 “time internal”结束前 48 小时 文档

商家 ID 可以删除吗?

目前,您无法从 Google Pay 和钱包控制台中删除或归档商家 ID。

如何使用 Applinking 功能?

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

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

目前不支持地理围栏。

如何设置会员回馈活动?

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

如何向 Google 发送公交卡的徽标?

请使用此表单向 Google 发送徽标以供列入许可名单。

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

确保您在整个流程中使用的是 UTF-8 编码。JSON 字符串会先进行 UTF-8 编码,然后使用 android.util.Base64(包含 NO_WRAP 和 网址_SAFE 选项)进行编码。这与 RFC 3548 第 4 节相对应。

如何以编程方式创建发卡机构账号?

如需通过 API 创建发卡机构账号,请参阅此指南

智能感应

我是否需要专用的 NFC 读卡器来读取 Google 智能感应卡券?

该终端必须支持智能触碰功能。您可以在此处查看经过认证的提供商列表。

如何将卡券用于 NFC?

请按照此配置,让您的卡券支持智能触碰兑换。

JSON Web 令牌 (JWT)

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

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

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

问题排查

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

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

我的徽标无法在我创建的卡券上呈现。可能出现了什么问题?

  • 首先,确保您的徽标符合指南,并以 PNG 格式保存。
  • 确保徽标随时可用且可靠性。请勿重定向到图片文件,否则会导致 404 错误。您的图片应托管在 HTTPS 位置,否则将无法显示在 Google 钱包中。
  • 确保在 API 中标记为必填的所有必填字段都已在卡券中设置。

支持与反馈

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

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

如何提供产品反馈?

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

如何提供文档反馈?

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