Google Pay API for Passes

借助 Google Pay API for Passes 平台，商家可以向数百万 Android 用户展示其会员卡、礼品卡、优惠、活动门票、航班登机牌和公交卡。

借助此 API，您可以创建一个链接或按钮，以便用户将会员卡、礼品卡、优惠、活动门票、航班登机牌和公交卡保存在 Google Pay 应用中。这些保存的内容以对象形式存储。

注意：本文档将对象概括为“卡券”。每个对象必须引用一个类。

您可以使用 API 通过基于位置的通知、动态和消息传递功能吸引客户与您的卡券进行互动，并在 Google Pay 应用中方便地管理这些卡券。

典型的集成流程

下图显示了与 Google Pay API for Passes 集成的典型流程。

成功集成的各个阶段都包括以下活动：

1. 技术发现
   1. 查看开发者文档。
   2. 创建服务帐号。
   3. 设计集成。
2. 技术集成
   1. 开发集成。
   2. 预演交付成果。
3. 验证和质量检查
   1. 执行质量检查测试。
   2. 查看用户体验设计（仅适用于登机牌和活动门票）。
4. 发布阶段
   1. 开始在不同区域发布。
   2. 开始众测。
5. 已发布
   1. 在所有区域上线。

推荐的集成策略

Google Pay API for Passes 支持下表中列出的卡券类别。 查看该表格，并选择按照卡券与集成类型推荐的集成策略。

注意：JSON Web 令牌 (JWT) 链接具有预先插入的类。这不适用于“瘦”JWT 链接。

	会员卡	优惠	礼品卡	活动门票 (ET)	航班登机牌 (BP)	公交卡 (TP)	分成组的票卡（仅限 BP、ET 和 TP）
网络浏览器	JavaScript (JS) 网页按钮	JS 网页按钮	JS 网页按钮	JS 网页按钮	JS 网页按钮	JS 网页按钮	JS 网页按钮
短信或电子邮件	JSON 网络令牌 (JWT) 链接	JWT 链接	JWT 链接	“瘦”JWT 链接	“瘦”JWT 链接	“瘦”JWT 链接	“瘦”JWT 链接
原生应用	JWT 链接	JWT 链接	JWT 链接	“瘦”JWT 链接 JWT POST 请求方法	“瘦”JWT 链接 JWT POST 请求方法	“瘦”JWT 链接 JWT POST 请求方法	“瘦”JWT 链接 JWT POST 请求方法
WebView	JWT 链接	JWT 链接	JWT 链接	JWT 链接	“瘦”JWT 链接	“瘦”JWT 链接	“瘦”JWT 链接

警告：如果可能的话，请避免将 WebView 与卡券集成一起使用，而是改为提示用户从原生应用保存其卡券。如果使用了 WebView，请实现 shouldOverrideUrlLoading 方法以便重定向到 pay.google.com。此实现类似于以下代码段：

@Override
      public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        if(request.getUrl().getHost().startsWith("pay.google.com")) {
          Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
          view.getContext().startActivity(intent);
          return true;
        }
        ...
        ...
      }

要了解适用于您的集成策略的卡券，请阅读以下有关卡券和 Google Pay 的信息。

保存到 Google Pay

所有卡券都支持使用 JavaScript 网络按钮从电子邮件或短信，以及具有 JWT 链接和 Intent 的 Android 应用，保存到 Google Pay。除此之外，支持使用原生 SDK 功能从 Android 应用保存的方式会有所不同，如下表所示：

	会员卡	优惠	礼品卡	活动门票	航班登机牌	公交卡
使用原生 SDK 从 Android 应用保存

如需了解详情，请参阅有关如何将卡券保存到 Google Pay 的实现详情。

从 Google Pay 兑换

所有卡券都支持“出示并扫描”兑换，以及“NFC 触碰”兑换。了解有关如何从 Google Pay 兑换卡券的实现详情。

通过 Google Pay 互动

重要提示：我们在对平台进行改进时，大多数用户都暂时无法使用关联的优惠和地理围栏通知。我们将在即将发布的版本中更新这些功能。

所有卡券均支持商家信息部分、自定义消息、自定义文本和图片部分以及兑换状态（用于确定用户是否已移除卡券及其本地化版本）。 下表列出了不同类型的卡券唯一支持的功能和通知：

	会员卡	优惠	礼品卡	活动门票	航班登机牌	公交卡
功能
模板
关联的优惠
来自 Google 助理的查询
通知
地理围栏通知
失效通知
部分字段更新通知
与即将举行的活动、即将搭乘的航班或即将开始的行程相关的通知

如需了解详情，请参阅有关如何通过 Google Pay 吸引用户的实现详情。

要查看每项功能在 Google Pay 应用中的外观，请参阅会员卡、礼品卡、优惠、活动门票、登机牌和公交卡的卡券模板页面。