FAQ Google Wallet API

Memulai

Apa itu Google Wallet API?

Google Wallet API memungkinkan developer membuat kartu digital di Google Wallet. Google Wallet API saat ini mendukung boarding pass, tiket acara, kartu loyalitas, penawaran, dan tiket transportasi umum. Baru-baru ini, jenis kartu umum ditambahkan untuk mendukung kasus penggunaan tambahan.

Bagaimana cara menyiapkan lingkungan pengembangan berdasarkan persyaratan dan kompleksitas bisnis saya?

Berikut adalah panduan yang dapat digunakan untuk menyiapkan lingkungan pengembangan yang sesuai dengan berbagai tingkat kompleksitas dan keamanan bisnis. Dengan menggunakan beberapa akun layanan, developer dapat membuat lingkungan TEST yang terpisah dari lingkungan PROD mereka.

Kompleksitas penyiapan dasar

1 akun konsol bisnis atau 1 akun induk konsol bisnis ke banyak akun penerbit.

  • Opsi ini memungkinkan pendekatan yang dikelola secara terpusat menggunakan 1 akun utama dengan nol hingga banyak sub-bisnis/penerbit.
  • 1 Project Google Cloud.
  • 1 kredensial akun layanan.
  • Satu set pengguna.

Kompleksitas penyiapan rata-rata

1 akun induk untuk banyak akun penerbit.

  • Opsi ini memungkinkan pendekatan yang dikelola secara terpusat menggunakan 1 akun utama dengan banyak sub-bisnis.
  • 1 Project Google Cloud.
  • Pengguna konsol bisnis unik per penerbit.
  • Kredensial akun layanan satu ke banyak.
    • 1 kredensial per bisnis/penerbit.
    • Akses kredensial yang berbeda per bisnis.

Kompleksitas penyiapan yang rumit

1 akun induk untuk banyak akun penerbit.

  • Opsi ini memungkinkan pendekatan yang dikelola secara terpusat menggunakan 1 akun utama dengan banyak sub-bisnis.
  • 1 hingga banyak Project Google Cloud.
  • Pengguna konsol bisnis unik per penerbit.
  • Kredensial akun layanan satu ke banyak.
    • 1 kredensial PROD per bisnis/penerbit.
    • 1 kredensial DEV per bisnis/penerbit.

Hubungi dukungan

Bekerja dengan Kartu

Bagaimana cara menghapus kelas atau objek?

Saat ini, Anda tidak dapat menghapus kelas atau objek dari Google Wallet. Namun, pengguna dapat membatalkan tautan objek dari Google Wallet mereka.

Bagaimana cara mengelompokkan beberapa kartu bersama-sama?

Dengan menggunakan GroupingID, Anda dapat mengelompokkan kartu dengan mudah.

Bagaimana cara memperbarui hanya sebagian kartu?

Ikuti panduan performa kami untuk memahami cara melakukan update parsial menggunakan permintaan PATCH.

Dapatkah saya membuat kartu secara berkelompok?

Ikuti panduan performa kami untuk memahami cara melakukan permintaan batch menggunakan API.

Pertanyaan Umum

Berapa batas rasio permintaan yang dikirim ke Google Wallet API?

Panggilan ke Google Wallet API dibatasi hingga 20 permintaan per detik.

Google Wallet API tidak memiliki SLA resmi, tetapi kami merekomendasikan waktu tunggu 10 detik, berdasarkan latensi persentil ke-99 sekitar 5 detik. Perhatikan juga bahwa latensi sering kali bergantung pada faktor eksternal, seperti waktu yang diperlukan untuk mengambil gambar yang dihosting di server eksternal saat menyisipkan objek dengan gambar tersebut, karena hal ini bergantung pada latensi server eksternal.

Mengapa gambar pribadi dilarang ditampilkan di kartu pas di Google Wallet?

Google Wallet tidak mendukung gambar pribadi pada kartu karena peraturan saat ini menyatakan bahwa semua konsumen memiliki hak untuk memilih tidak mengizinkan pengumpulan atau pemrosesan data sensitif. Dengan memiliki data sensitif (gambar pribadi) sebagai bagian dari objek berharga (dalam JWT), ada kemungkinan masalah hosting di mana data dapat menjadi publik yang berada di luar perjanjian izin asli. Untuk memastikan kerahasiaan data, gambar pribadi tidak diizinkan. Kami sedang berupaya mendukung gambar pribadi pada masa mendatang.

Kode error apa yang ditampilkan oleh Google Wallet API?

Untuk mengetahui daftar kode error dan pengecualian yang ditampilkan oleh Google Wallet API, lihat Kode error.

Bagaimana cara mengaktifkan notifikasi push?

Notifikasi push yang dibuat developer saat ini tidak didukung oleh Google Wallet. Namun, Google Wallet memberikan notifikasi tepat waktu untuk kartu berikut. Notifikasi push yang dibuat developer saat ini tidak didukung oleh Google Wallet.

Vertical Notifikasi Dipicu Dokumentasi
Acara Pengingat terjadwal 3 jam sebelum acara dokumen
Boarding pass Pengingat terjadwal 3 jam sebelum keberangkatan penerbangan dokumen
Boarding pass Pembaruan Kartu Perubahan terminal asal, gerbang, waktu naik pesawat, atau waktu keberangkatan dokumen
Kartu penawaran Pengingat habis masa berlaku 48 jam sebelum kartu penawaran berakhir dokumen
Generik Pengingat terjadwal 24 jam sebelum “interval waktu” dimulai dokumen
Generik Pengingat habis masa berlaku 48 jam sebelum “waktu internal” berakhir dokumen

Dapatkah ID penjual dihapus?

Saat ini, ID penjual tidak dapat dihapus atau diarsipkan dari Konsol Google Pay & Wallet.

Bagaimana cara menggunakan fitur Applinking?

Applinking memerlukan pengizinan yang dapat diminta di sini.

Apakah Google Wallet mendukung Geofencing?

Geofencing saat ini tidak didukung.

Bagaimana cara menyiapkan program loyalitas?

Anda dapat menyiapkan program pendaftaran dan loyalitas dengan mengikuti panduan ini.

Bagaimana cara mengirimkan logo saya ke Google untuk kartu Transit?

Gunakan formulir ini untuk mengirimkan logo ke Google agar dimasukkan dalam daftar yang diizinkan.

Bagaimana cara menangani data userProfile berenkode Base64 dengan benar?

Pastikan Anda menggunakan encoding UTF-8 di seluruh proses. String JSON pertama-tama dienkode UTF-8 dan selanjutnya dienkode menggunakan android.util.Base64 dengan opsi NO_WRAP dan URL_SAFE. Hal ini sesuai dengan RFC 3548 bagian 4.

Bagaimana cara membuat akun Penerbit secara terprogram?

Lihat panduan ini untuk membuat akun penerbit melalui API.

Smart Tap

Apakah saya memerlukan pembaca NFC khusus untuk kartu Google SmartTap?

Terminal harus kompatibel dengan SmartTap. Daftar penyedia tersertifikasi dapat ditemukan di sini.

Bagaimana cara membuat kartu saya berfungsi dengan NFC?

Ikuti konfigurasi ini agar kartu Anda dapat ditukarkan dengan Smart Tap.

Token web JSON (JWT)

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 memiliki afiliasi dan tidak secara khusus merekomendasikan pihak ketiga tersebut.

Anda dapat membuat class dan objek terlebih dahulu menggunakan API sebelum membuat link kartu tersimpan (JWT).

Pemecahan masalah

Mengapa setelan waktu saya menampilkan waktu yang salah untuk acara?

Waktu yang ditampilkan pada kartu adalah waktu lokal acara, dengan selisih waktu untuk lokasi acara.

Logo saya tidak dirender di Kartu yang telah saya buat. Apa yang salah?

  • Pertama, pastikan logo Anda mengikuti panduan dan disimpan dalam format PNG.
  • Pastikan logo tersedia dengan keandalan tinggi. Jangan mengalihkan ke file gambar yang dapat menyebabkan error 404. Gambar Anda harus dihosting di lokasi HTTPS karena jika tidak, gambar tidak akan terlihat di Google Wallet.
  • Pastikan semua kolom wajib diisi yang ditandai sebagai wajib diisi di API ditetapkan dalam kartu.

Dukungan & masukan

Bagaimana cara menghubungi dukungan teknis?

Untuk mendapatkan bantuan tambahan, hubungi tim dukungan dengan mengklik tombol 'Hubungi Dukungan' di sidebar kiri konsol Google Pay dan Wallet.

Bagaimana cara memberikan masukan produk?

Untuk memberikan masukan produk, klik tombol "Kirim Masukan" di kuadran kanan atas halaman situs developer, lalu pilih "Masukan produk". Selanjutnya, jelaskan masukan Anda di area teks, lalu klik "Kirim".

Bagaimana cara memberikan masukan dokumentasi?

Untuk memberikan masukan dokumentasi, klik tombol "Kirim Masukan" di kuadran kanan atas halaman situs developer, lalu pilih "Masukan dokumentasi". Selanjutnya, jelaskan masukan Anda di area teks, lalu klik "Kirim".