W tym dokumencie opisano czynności, jakie musi wykonać operator transportu publicznego i jego integrator systemu, nazywany tutaj wydawcą, aby udostępnić implementację Motics w Portfelu Google.
1. Spełnij wymagania wstępne
- Podpisz z Google umowę o nieujawnianiu informacji. Ten formularz online typu „kliknij, aby zaakceptować” jest udostępniany przez zespół Google ds. rozwoju działalności.
- Przeprowadź integrację ze standardowym interfejsem Google Wallet API dla kodów QR:
- Wydawca używa interfejsu Google Wallet API do obsługi administracyjnej kart i dodawania ich do aplikacji Portfel Google użytkownika. Zapoznaj się z dokumentacją kodów QR transportu publicznego i spełnij wymagania wstępne, aby przeprowadzić integrację z interfejsem API.
- Zarejestruj się w usłudze VDV eTicket Service, aby uzyskać identyfikator właściciela (orgId) oraz odpowiednie informacje o infrastrukturze klucza publicznego wymagane przez Motics.
2. Implementacja techniczna
Drugi etap zawiera główne szczegóły techniczne wdrożenia, które należy opracowywać równolegle.
Uaktualnij interfejs Google Wallet API
Na stronie Szczegóły techniczne znajdują się metody i parametry, których wydawca musi używać i aktualizować na potrzeby integracji z Motics. W szczególności wydawca musi wywoływać te metody interfejsu API Portfela Google z dodatkowymi parametrami powiązanymi z Motics:
Wdróż punkt końcowy aktywacji
Serwer Google wywołuje punkt końcowy aktywacji hostowany przez wydawcę. Spowoduje to wygenerowanie statycznych danych dotyczących upoważnienia (sigSTB) na serwerze wydawcy. Szczegółowe informacje znajdziesz w sekcji punktu końcowego aktywacji.
Wdrażanie procesu przenoszenia i odłączania
Aby zapewnić użytkownikom wygodę, użytkownik powinien mieć możliwość przeniesienia biletu Motics z jednego urządzenia na drugie w ramach określonych przez wydawcę karty. W tym celu wydawca musi zaimplementować proces przenoszenia i odłączenia.
Wyślij e-maila z potwierdzeniem podczas zapisywania biletu
Google wymaga, aby wydawca wysyłał do użytkowników e-maila z potwierdzeniem, gdy zapisują bilet Motics w Portfelu Google. E-mail z potwierdzeniem powinien zawierać co najmniej:
- Przydatne linki dla użytkowników do zarządzania biletem (subskrypcją).
- Instrukcje kontaktowania się z obsługą klienta wydawcy.
3. Wykonaj kompleksowe testy integracji w narzędziu STAGING
Utwórz test transitClass w Portfelu Google do użytku programistycznego, a po zakończeniu integracji rozwiązanie musi zostać zweryfikowane i przetestowane w całości za pomocą tego programistycznego transitClass. W transitObject:Insert ustaw cert_environment na STAGING. Wszystkie przypadki użycia powinny być w pełni przetestowane,
a wszystkie przypadki testowe muszą zakończyć się sukcesem.
4. Przeprowadź kompleksowe testy w środowisku PRODUKCYJNYM
Gdy rozwiązanie zostanie przetestowane w środowisku STAGING, utwórz nową produkcję transitClass. Tym razem podczas wstawiania transitObject ustaw cert_environment na PRODUCTION. Wykonaj wszystkie instrukcje i przypadki testowe z sekcji Testowanie.
5. Przebieg procesu wprowadzania aplikacji na rynek i uzyskaj zatwierdzenia
Przed uruchomieniem lub rozpoczęciem publicznego programu pilotażowego firma Google musi uzyskać pełne zatwierdzenie. Zatwierdzenie zależy od wyniku różnych faz testów oraz od innych czynników, takich jak:
- Ogólny zakres i plan wprowadzenia
- W przypadku wdrożenia pilotażowego plan wprowadzenia musi zawierać jasne kryteria zakończenia i harmonogramy, aby umożliwić pełne wdrożenie.
- Zaplanowane działania marketingowe
- Komunikaty dotyczące uruchomienia
- Data wprowadzenia
- Oś czasu wprowadzenia na rynek, proces eskalacji i kontakty
- Procesy pomocy dla użytkowników końcowych