Questo documento illustra i passaggi che un operatore di trasporto pubblico (PTO) e il suo integratore di sistemi, di seguito denominato emittente, devono seguire per fornire un'implementazione di Motics in Google Wallet.
1. Completa i prerequisiti
- Firma un accordo di non divulgazione (NDA) con Google. Questo modulo online da accettare con un clic è condiviso dal team di sviluppo aziendale (BD) di Google.
- Esegui l'integrazione con l'API Google Wallet standard per i codici QR:
- L'emittente utilizza l'API Google Wallet per eseguire il provisioning delle tessere e aggiungerle all'app Google Wallet di un utente. Consulta la documentazione sui codici QR per il trasporto pubblico e completa i prerequisiti necessari per l'integrazione con l'API.
- Registrati al servizio VDV eTicket per ottenere unownerId (orgId) e i dettagli dell'infrastruttura a chiave pubblica pertinenti richiesti per Motics.
2. Implementazione tecnica
Il passaggio 2 contiene i principali dettagli di implementazione tecnica, che dovrebbero essere sviluppati in parallelo.
Esegui l'upgrade dell'implementazione dell'API Google Wallet
La pagina Dettagli tecnici illustra i metodi e i parametri che l'emittente deve utilizzare e aggiornare per l'integrazione di Motics. In particolare, l'emittente deve chiamare i seguenti metodi dell'API Google Wallet con parametri aggiuntivi correlati a Motics:
Implementa l'endpoint di attivazione
Il server di Google chiama l'endpoint di attivazione ospitato dall'emittente. Ciò attiva la generazione dei dati statici sui diritti (sigSTB) sul server emittente. Per informazioni dettagliate, consulta la sezione relativa agli endpoint di attivazione.
Implementazione del flusso di spostamento e scollegamento
Per offrire una buona esperienza utente, un utente deve essere in grado di spostare il proprio biglietto Motics da un dispositivo a un altro, entro determinati limiti definiti dall'emittente. Per farlo, l'emittente deve implementare il flusso di spostamento e scollegamento.
Invia un'email di conferma al salvataggio del biglietto
Google richiede che l'emittente invii un'email di conferma agli utenti quando salvano un biglietto Motics su Google Wallet. L'email di conferma dovrebbe contenere (almeno) quanto segue:
- Link utili che consentono agli utenti di gestire i loro biglietti (abbonamento).
- Istruzioni su come contattare l'assistenza clienti dell'emittente.
3. Esegui test di integrazione end-to-end in STAGING
Crea un transitClass di test di Google Wallet per uso in fase di sviluppo e, una volta completato il lavoro di integrazione, la soluzione deve essere convalidata e testata end-to-end utilizzando questo transitClass di sviluppo. In transitObject:Insert,
imposta cert_environment su STAGING. Tutti i casi d'uso devono essere testati
completamente e tutti i casi di test devono avere un risultato positivo.
4. Esegui test end-to-end in PRODUCTION
Dopo aver testato la soluzione utilizzando l'ambiente STAGING, crea un nuovo transitClass di produzione. Questa volta imposta cert_environment su
PRODUCTION durante l'inserimento del transitObject. Segui e completa tutti gli scenari di test e le istruzioni nella sezione Test.
5. Segui la procedura di lancio e ottieni le approvazioni
Prima di avviare o avviare un progetto pilota pubblico, l'approvazione completa del lancio deve essere stata concessa da Google. L'approvazione dipende dall'esito delle varie fasi di test e da altri fattori quali, a titolo esemplificativo, i seguenti che devono essere esaminati e approvati da Google:
- Ambito e piano generali del lancio
- In caso di un progetto pilota, il piano di lancio deve includere criteri di uscita chiari e tempistiche per procedere con un lancio completo.
- Attività di marketing pianificate
- Comunicazioni sul lancio
- Data di lancio
- Tempistiche del giorno di lancio, procedura di riassegnazione e contatti
- Processi di assistenza per l'utente finale