Fitur pendaftaran Kartu Hadiah (login) memungkinkan pengguna menelusuri kartu voucher dan menambahkannya ke Google Wallet. Pengguna akan diarahkan ke situs yang mobile-friendly untuk menyelesaikan baru. Setelah itu, mereka dapat menambahkan kartunya ke Google Wallet.
Panduan ini memberikan ringkasan langkah-langkah penerapan yang diperlukan untuk mengaktifkan program kartu voucher Anda untuk fitur ini.
Ringkasan
Untuk memulai, pastikan Anda telah menyiapkan proyek Anda sebelumnya dan memiliki akses ke API Google Wallet.
Anda harus mengikuti empat langkah ini untuk menerapkan fitur login untuk program kartu voucher Anda:
- Siapkan kelas pengujian di Google Wallet untuk menguji alur login Anda.
- Mengembangkan halaman masuk yang menggunakan Google Wallet
SharedDataType
. - Terapkan push back kartu voucher ke Google Wallet setelah login.
- Minta verifikasi dan aktivasi.
Menyiapkan kelas pengujian di Google Wallet
Tentukan URL login, logo program Anda. Lalu:
gunakan kolom bertingkat discoverableProgram
di
giftcardclass
untuk menetapkan
nilai-nilai yang sesuai.
Tetapkan nilai di discoverableProgram
untuk membuat versi draf
program kartu voucher yang diaktifkan untuk login. Untuk memastikan elemen ini dapat dilihat
oleh penguji, pastikan bahwa
penguji memiliki akses ke Konsol Google Pay dan Wallet Anda. Untuk detail tentang cara berbagi
Akses Google Pay dan Konsol Wallet dengan orang lain, lihat
Pelajari halaman Pengguna.
Untuk menyelesaikan verifikasi fungsi implementasi Anda selama pengembangan hubungi kami menggunakan widget dukungan kontak di Konsol Google Pay dan Wallet. Saat di konsol, pilih Google Wallet API dalam topik, lalu pilih Login dengan kartu hadiah subtopik.
Mengembangkan halaman login yang menggunakan data pengguna Google Wallet
Saat pengguna memilih untuk menambahkan kartu voucher, mereka diarahkan ke halaman yang disesuaikan di {i>website<i} Anda untuk menyelesaikan proses login.
Anda harus memberikan URL login tempat pengguna dapat login ke akun yang ada.
Halaman login Anda harus memenuhi persyaratan berikut:
- Berikan pengalaman pengguna yang mobile-friendly.
- Izinkan pengguna menyelesaikan proses login dalam satu halaman.
- Gunakan enkripsi
HTTPS
dengan sertifikat yang valid untuk memastikan data pengguna ditransmisikan dengan aman. - Pastikan waktu beroperasi halaman login Anda setidaknya 99,9%.
Saat menampilkan halaman login, Google Wallet akan membuat
Android WebView dan permintaan POST
dibuat ke permintaan
. Data pengguna disediakan dalam parameter SharedDataType
yang disertakan dalam permintaan POST
menggunakan
application/x-www-form-urlencoding dan
Encoding UTF-8
. Nilai SharedDataType
adalah objek JSON berenkode Base64.
Terapkan push back kartu voucher dengan segera ke Google Wallet
Setelah diautentikasi (masuk), halaman Anda harus segera mengirim kembali kartu voucher pengguna ke Google Wallet.
Anda dapat mengirim kembali kartu voucher ke Google Wallet dengan mengalihkannya ke tautan yang mengikuti struktur
https://pay.google.com/gp/v/save/{jwt_generated}
Panjang aman untuk URL adalah 2.000 karakter. Tautan Anda harus tetap berada di bawah batas ini. Objek yang dienkode dalam JWT harus kecil, hanya berisi data yang spesifik untuk pengguna. Coba simpan sebagian besar data di class objek, membuatnya sebelum membuat JWT. Untuk objek yang lebih besar yang tidak sesuai dengan batas, pertimbangkan pertama kali membuat objek di Google Wallet API dan hanya mengirimkan ID objek di JWT.
Alur Komunikasi Umum
Alur komunikasi untuk pengguna yang menyelesaikan proses login diilustrasikan di gambar berikut. Semua tindakan antara "Server Anda" Anda tanggung jawab untuk menerapkannya.
Meminta verifikasi dan aktivasi
Setelah Anda menyelesaikan pekerjaan pengembangan dan menguji alur login, kirim permintaan melalui Hubungi dukungan Konsol Google Pay dan Wallet .
Setelah peninjauan menyeluruh terhadap penerapan Anda yang memastikan fitur yang benar dalam dikombinasikan dengan aplikasi Google Wallet, fitur login kartu voucher akan diluncurkan secara publik untuk program kartu voucher Anda. Ini akan memungkinkan setiap pengguna untuk melihat program dan memanfaatkan fitur ini.
Untuk memastikan pengalaman pengguna yang optimal, pemeriksaan berulang terhadap login Anda akan diterapkan untuk memastikan kepatuhan berkelanjutan terhadap persyaratan fitur. Anda akan diberi tahu jika terjadi perbedaan dan fitur login mungkin dinonaktifkan hingga masalah teratasi.
Pertanyaan Umum (FAQ)
- Apakah ada persyaratan untuk gambar yang digunakan dalam program kartu voucher saya?
- Ya, gambar Anda harus dihosting di
HTTPS
lokasi karena tidak akan terlihat di Google Wallet.
- Ya, gambar Anda harus dihosting di
- Apakah ada alat yang menyederhanakan implementasi dan proses debug JWT?
- Ya, platform seperti www.jwt.io memungkinkan Anda mendekode dan men-debug token selama proses pengembangan, memungkinkan Anda untuk memverifikasi konten yang Anda kirimkan. Perhatikan bahwa Google tidak memiliki afiliasi dan tidak secara khusus merekomendasikan pihak ketiga tersebut.
- Bagaimana cara menangani data SharedDataType berenkode Base64 dengan benar?
- Pastikan Anda menggunakan encoding UTF-8 selama proses berlangsung. String JSON pertama kali dikodekan dengan UTF-8 dan kemudian dikodekan menggunakan android.util.Base64 dengan opsi NO_WRAP dan URL_SAFE. Hal ini sesuai dengan RFC 3548 bagian 4.