Pendaftaran Kartu Voucher Pengguna

Fitur pendaftaran (login) Kartu Voucher memungkinkan pengguna menelusuri kartu voucher dan menambahkannya ke Google Wallet. Pengguna akan diarahkan ke situs Anda yang mobile-friendly untuk menyelesaikan prosesnya, setelah itu mereka dapat menambahkan kartu 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 project sebelumnya dan memiliki akses ke Google Wallet API.

Anda harus mengikuti empat langkah berikut untuk menerapkan fitur login untuk program kartu voucher Anda:

1. Siapkan class pengujian di Google Wallet untuk menguji alur login Anda.
2. Mengembangkan halaman login yang menggunakan Google Wallet SharedDataType.
3. Mengimplementasikan penundaan kartu voucher ke Google Wallet setelah login.
4. Minta verifikasi dan pengaktifan.

Menyiapkan class pengujian di Google Wallet

Tentukan URL login, logo program Anda. Kemudian, gunakan kolom bertingkat discoverableProgram di giftcardclass untuk menetapkan nilai yang sesuai.

Tetapkan nilai di discoverableProgram untuk membuat versi draf program kartu voucher yang mengaktifkan login. Untuk memastikan ini terlihat oleh penguji, pastikan penguji memiliki akses ke Konsol Google Pay dan Wallet Anda. Untuk mengetahui detail tentang cara membagikan akses Konsol Google Pay dan Wallet kepada orang lain, lihat Pelajari halaman Pengguna.

Untuk menyelesaikan verifikasi fungsi penerapan Anda selama proses pengembangan, hubungi kami menggunakan widget dukungan kontak di Konsol Google Pay dan Wallet. Saat berada di konsol, pilih Google Wallet API dalam topik, lalu pilih Login kartu voucher dalam subtopik.

Mengembangkan halaman login yang menggunakan data pengguna Google Wallet

Saat pengguna memilih untuk menambahkan kartu voucher Anda, mereka akan diarahkan ke halaman yang disesuaikan di situs 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 mudah diakses di perangkat seluler.
• Izinkan pengguna menyelesaikan login dalam satu halaman.
• Gunakan enkripsi HTTPS dengan sertifikat yang valid untuk memastikan data pengguna dikirim dengan aman.
• Pastikan waktu operasional halaman login Anda minimal 99,9%.

Saat menampilkan halaman login, Google Wallet akan membuat WebView Android dan permintaan POST dibuat ke URL yang Anda berikan. Data pengguna disediakan dalam parameter SharedDataType yang disertakan dalam permintaan POST menggunakan jenis konten application/x-www-form-urlencoded dan enkode UTF-8. Nilai parameter SharedDataType adalah objek JSON yang dienkode Base64.

Catatan: String JSON pertama kali dienkode UTF-8, lalu dienkode menggunakan android.util.Base64 dengan opsi NO_WRAP dan URL_SAFE. Hal ini sesuai dengan RFC 3548 bagian 4.

Mengimplementasikan penundaan langsung kartu voucher ke Google Wallet

Setelah diautentikasi (login), halaman Anda harus segera mengirim kembali kartu voucher pengguna ke Google Wallet.

Catatan: Jangan terapkan tombol Google Wallet API karena pengguna harus diarahkan kembali ke Google Wallet tanpa interaksi pengguna tambahan.

Anda dapat mengirim kembali kartu voucher ke Google Wallet dengan mengalihkan ke link yang mengikuti struktur

https://pay.google.com/gp/v/save/{jwt_generated}

Catatan: Pastikan untuk menyertakan '/' di akhir URL sebelum JWT.

Catatan: JWT tidak dienkripsi. Hanya sertakan data dalam deep link yang aman untuk dibagikan sebagai teks biasa.

Panjang yang aman untuk URL adalah 2.000 karakter. Link Anda harus tetap berada di bawah batas ini. Objek yang dienkode dalam JWT harus berukuran kecil, hanya berisi data yang spesifik untuk pengguna. Coba simpan sebagian besar data di class objek, buat sebelum membuat JWT. Untuk objek yang lebih besar yang tidak sesuai dengan batas, sebaiknya buat objek terlebih dahulu di Google Wallet API dan hanya kirim ID objek di JWT.

Alur Komunikasi Umum

Alur komunikasi untuk pengguna yang menyelesaikan login diilustrasikan dalam gambar berikut. Semua tindakan antara "Server Anda" adalah tanggung jawab Anda untuk menerapkannya.

Meminta verifikasi dan pengaktifan

Setelah menyelesaikan pekerjaan pengembangan dan menguji alur login, kirim permintaan melalui widget dukungan kontak Konsol Google Pay dan Wallet.

Setelah peninjauan lengkap terhadap penerapan Anda yang mengonfirmasi fitur yang benar bersama dengan aplikasi Google Wallet, fitur login kartu voucher akan diluncurkan secara publik untuk program kartu voucher Anda. Tindakan ini akan memungkinkan pengguna mana pun melihat program dan menggunakan fitur ini.

Untuk memastikan pengalaman pengguna yang optimal, pemeriksaan berulang terhadap penerapan login Anda akan dilakukan untuk memastikan kepatuhan berkelanjutan terhadap persyaratan fitur. Anda akan diberi tahu jika terjadi perbedaan dan fitur login dapat dinonaktifkan hingga masalah tersebut diselesaikan.

Pertanyaan Umum (FAQ)

• Apakah ada persyaratan untuk gambar yang digunakan dalam program kartu voucher saya?
  • Ya, gambar Anda harus dihosting di lokasi HTTPS karena jika tidak, gambar tidak akan terlihat di Google Wallet.
• Apakah ada alat yang menyederhanakan penerapan dan proses debug JWT?
  • Ya, platform seperti www.jwt.io memungkinkan Anda mendekode dan men-debug token selama proses pengembangan, sehingga Anda dapat memverifikasi konten yang Anda kirimkan. Perhatikan bahwa Google tidak berafiliasi dan tidak merekomendasikan pihak ketiga tersebut secara khusus.
• Bagaimana cara menangani data SharedDataType yang dienkode Base64 dengan benar?
  • Pastikan Anda menggunakan encoding UTF-8 di seluruh proses. String JSON pertama kali dienkode UTF-8, lalu dienkode menggunakan android.util.Base64 dengan opsi NO_WRAP dan URL_SAFE. Hal ini sesuai dengan RFC 3548 bagian 4.