Dokumen ini membahas langkah-langkah yang perlu dilakukan Operator Transportasi Umum (PTO) dan integrator sistemnya, yang selanjutnya disebut sebagai penerbit, untuk menyediakan implementasi Motics di Google Wallet.
1. Selesaikan Prasyarat
- Menandatangani perjanjian kerahasiaan (NDA) dengan Google. Formulir online klik untuk menyetujui ini dibagikan oleh tim pengembangan bisnis (BD) Google.
- Integrasikan dengan Google Wallet API standar untuk kode QR:
- Penerbit menggunakan Google Wallet API untuk menyediakan kartu dan menambahkannya ke aplikasi Google Wallet pengguna. Tinjau dokumentasi Kode QR Transit dan selesaikan prasyarat yang diperlukan untuk melakukan integrasi dengan API.
- Mendaftar ke Layanan eTicket VDV untuk mendapatkan ownerId (orgId) dan detail IKP relevan yang diperlukan untuk Motics.
2. Implementasi Teknis
Langkah 2 berisi detail implementasi teknis utama, yang harus dikembangkan secara paralel.
Mengupgrade Implementasi Google Wallet API Anda
Halaman Detail Teknis menguraikan metode dan parameter yang perlu digunakan dan diupdate penerbit untuk integrasi Motics. Secara khusus, penerbit harus memanggil metode Google Wallet API berikut dengan parameter terkait Motics tambahan:
Menerapkan endpoint aktivasi
Server Google memanggil endpoint aktivasi yang dihosting penerbit. Tindakan ini akan memicu pembuatan data hak statis (sigSTB) di server penerbit. Tinjau bagian endpoint aktivasi untuk mengetahui detailnya.
Menerapkan Alur Pemindahan & Batalkan Tautan
Untuk memberikan pengalaman pengguna yang baik, pengguna harus dapat memindahkan tiket Motics dari satu perangkat ke perangkat lainnya, dalam batas tertentu yang ditentukan oleh penerbit. Untuk itu, penerbit harus menerapkan Alur Pemindahan dan Batalkan Tautan.
Mengirim email konfirmasi tentang penyimpanan tiket
Google mewajibkan penerbit mengirimkan email konfirmasi kepada pengguna saat mereka menyimpan tiket Motics ke Google Wallet. Email konfirmasi (minimal) harus berisi:
- Link yang berguna bagi pengguna untuk mengelola tiket (langganan) mereka.
- Petunjuk cara menghubungi dukungan pelanggan penerbit.
3. Lakukan pengujian integrasi menyeluruh dalam STAGING
Buat transitClass pengujian Google Wallet untuk penggunaan pengembangan dan setelah
pekerjaan integrasi selesai, solusi perlu divalidasi dan diuji
secara menyeluruh menggunakan transitClass pengembangan ini. Di transitObject:Insert, tetapkan cert_environment ke STAGING. Semua kasus penggunaan harus diuji sepenuhnya
dan semua kasus pengujian harus memiliki hasil yang sukses.
4. Lakukan pengujian menyeluruh pada PRODUKSI
Setelah solusi berhasil diuji menggunakan lingkungan STAGING, buat transitClass produksi baru. Kali ini setel cert_environment ke
PRODUCTION saat menyisipkan transitObject. Ikuti dan selesaikan semua kasus
dan petunjuk pengujian di bagian Pengujian.
5. Ikuti proses peluncuran & dapatkan persetujuan
Sebelum meluncurkan atau memulai uji coba publik, persetujuan peluncuran penuh harus diberikan oleh Google. Persetujuan bergantung pada hasil dari berbagai fase pengujian serta faktor lain seperti (tetapi tidak terbatas pada) hal berikut yang harus ditinjau dan disetujui oleh Google:
- Cakupan & rencana peluncuran secara keseluruhan
- Dalam kasus uji coba, rencana peluncuran harus menyertakan kriteria dan linimasa keluar yang jelas untuk melanjutkan ke peluncuran penuh.
- Rencana Kegiatan Pemasaran
- Luncurkan Komunikasi
- Tanggal Peluncuran
- Jadwal hari peluncuran serta proses eskalasi & kontak
- Proses dukungan pengguna akhir