Google 钱包中 Motics 票券的发卡机构集成步骤

本文档讨论了公共交通运营商 (PTO) 及其系统集成商（以下称为发卡机构）在 Google 钱包中提供 Motics 实现需采取的步骤。

1. 完成前提条件

  • 与 Google 签署保密协议 (NDA)。此点击接受在线表单由 Google 的业务发展 (BD) 团队分享。
  • 与标准 Google Wallet API 集成以使用二维码：
    • 发卡机构使用 Google Wallet API 配置卡券，并将其添加到用户的 Google 钱包应用。请查看公交二维码文档，并满足与该 API 集成的必要前提条件。
  • 向 VDV eTicket 服务注册，以获取 Motics 所需的 OwnerId (orgId) 和相关的 PKI 详细信息。

2. 技术实现

第 2 步包含主要的技术实现细节，这些细节应该同时进行。

升级您的 Google Wallet API 实现

技术详情页面概述了发卡机构在 Motics 集成过程中需要使用和更新的方法和参数。具体而言，发卡机构需要调用以下 Google Wallet API 方法以及额外的 Motics 相关参数：

实现激活端点

Google 服务器调用发卡机构托管的激活端点。这会触发在颁发者服务器上生成静态使用权数据 (sigSTB)。如需了解详情，请查看激活端点部分。

为了提供良好的用户体验，用户应该能够在发卡机构规定的特定限制内，将其 Motics 票券从一台设备转移到另一台设备。为此，发卡机构必须实施移动和解除关联流程。

保存票券时发送确认电子邮件

Google 要求发卡机构在用户将 Motics 票券保存到 Google 钱包时向其发送确认电子邮件。确认电子邮件应（至少）包含以下内容：

  • 供用户管理其工单（订阅）的实用链接。
  • 有关如何与发卡机构的客户支持团队联系的说明。

3. 在 STAGING 中执行端到端集成测试

创建 Google 钱包测试 transitClass 以供开发使用，集成工作完成后，需要使用此开发 transitClass 对解决方案进行验证和测试端到端测试。在 transitObject:Insert 中，将 cert_environment 设置为 STAGING。所有用例都应经过全面测试，并且所有测试用例都必须成功完成结果。

4. 在正式版中执行端到端测试

使用 STAGING 环境成功测试解决方案后，创建一个新的生产 transitClass。这次在插入 transitObject 时，将 cert_environment 设置为 PRODUCTION。遵循并完成测试部分中的所有测试用例和说明。

5. 遵循发布流程并获得批准

在启动或开始公开测试之前，必须获得 Google 的全面发布批准。审批结果取决于各种测试阶段的结果以及其他因素，例如（但不限于）以下必须经过 Google 审核和批准的因素：

  • 总体发布范围和计划
    • 如果是小规模测试，发布计划必须包括明确的退出标准和时间表，以便进行全面发布。
  • 计划的营销活动
  • 启动通信
  • 发布日期
  • 发布日期时间表、上报流程和联系人
  • 最终用户支持流程