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 审核和批准的因素:

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