本文档讨论了公共交通运营商 (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 审核和批准的因素:
- 总体发布范围和计划
- 如果是小规模测试,发布计划必须包括明确的退出标准和时间表,以便进行全面发布。
- 计划的营销活动
- 启动通信
- 发布日期
- 发布日期时间表、上报流程和联系人
- 最终用户支持流程