FAQ Google Wallet API

Memulai

Apa yang dimaksud dengan 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 multi-trip. Baru-baru ini, jenis kartu umum ditambahkan untuk mendukung kasus penggunaan lain.

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

Berikut adalah panduan yang dapat digunakan untuk menyiapkan lingkungan pengembangan yang memenuhi berbagai tingkat kompleksitas dan keamanan bisnis. Menggunakan beberapa akun layanan dapat memungkinkan developer 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 kumpulan pengguna.

Kompleksitas penyiapan rata-rata

1 akun induk ke 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 yang berbeda per penerbit.
  • 1 hingga banyak kredensial akun layanan.
    • 1 kredensial per bisnis/penerbit.
    • Akses kredensial yang berbeda per bisnis.

Kompleksitas penyiapan yang rumit

1 akun induk ke 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 yang berbeda per penerbit.
  • 1 ke banyak kredensial akun layanan.
    • 1 kredensial PROD per bisnis/penerbit.
    • 1 kredensial DEV per bisnis/penerbit.

Hubungi dukungan

Menggunakan Kartu

Bagaimana cara menghapus class atau objek?

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

Bagaimana cara mengelompokkan beberapa kartu?

Penggunaan GroupingID memudahkan pengelompokan kartu.

Bagaimana cara memperbarui hanya sebagian kartu?

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

Dapatkah saya membuat kartu secara massal?

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

Pertanyaan Umum

Berapa batas kapasitas untuk permintaan yang dikirim ke Google Wallet API?

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

Mengapa gambar pribadi dilarang ada di kartu di Google Wallet?

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

Kode error apa yang dikembalikan 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?

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

Vertikal Notifikasi Dipicu Dokumentasi
Acara Pengingat terjadwal 3 jam sebelum acara docs
Tiket pesawat Pengingat terjadwal 3 jam sebelum keberangkatan penerbangan dokumen
Tiket pesawat Pembaruan Kartu Terminal asal, gerbang, waktu naik, atau perubahan waktu keberangkatan docs
Kartu penawaran Pengingat habis masa berlaku 48 jam sebelum kartu penawaran berakhir docs
Generik Pengingat terjadwal 24 jam sebelum “interval waktu” dimulai docs
Generik Pengingat masa berlaku habis 48 jam sebelum “waktu internal” berakhir docs

Apakah ID penjual dapat dihapus?

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

Bagaimana cara menggunakan fitur Penautan Aplikasi?

Applinking memerlukan daftar yang diizinkan yang dapat diminta di sini.

Apakah Google Wallet mendukung Pembatasan Wilayah?

Pembatasan wilayah 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 tiket Transit?

Gunakan formulir ini untuk mengirimkan logo kepada Google agar diizinkan.

Bagaimana cara menangani data userProfile berenkode Base64 dengan benar?

Pastikan Anda menggunakan encoding UTF-8 sepanjang proses. String JSON pertama kali dienkode menggunakan UTF-8, lalu 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 mendukung SmartTap. Daftar penyedia tersertifikasi dapat ditemukan di sini.

Bagaimana cara agar 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 implementasi 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 dikirimkan. Perhatikan bahwa Google tidak berafiliasi dan tidak merekomendasikan pihak ketiga tersebut secara khusus.

Anda dapat melakukan pra-pembuatan class dan objek menggunakan API sebelum membuat link simpan kartu (JWT).

Pemecahan masalah

Mengapa setelan waktu saya menampilkan waktu yang salah untuk acara?

Waktu yang ditampilkan di kartu adalah waktu lokal untuk acara, dengan offset untuk waktu tempat acara berlangsung.

Logo saya tidak akan 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 tersebut tidak akan terlihat di Google Wallet.
  • Pastikan semua kolom wajib diisi yang ditandai sebagai wajib diisi di API ditetapkan di 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 terkait 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 dan klik "Kirim".