Dokumen ini mencantumkan terminologi dan konsep umum yang harus Anda pahami saat menggunakan Google Wallet API.
Operan
Lewat
Kartu adalah instance Objek Kartu yang diberikan kepada pengguna untuk disimpan di Google Wallet mereka. Google Wallet API memberikan dukungan untuk sejumlah jenis kartu umum, termasuk boarding pass, tiket acara, kartu tanda pengenal, dan lainnya. Google Wallet API juga menyediakan jenis kartu Generik yang dapat digunakan untuk membuat kartu yang tidak didukung secara khusus.
Pada umumnya, kartu dibuat menggunakan Class Kartu dan Objek Kartu.
Penerbit Kartu
Penerbit Kartu adalah entitas yang membuat kartu dan menerbitkannya kepada pengguna untuk disimpan di Google Wallet mereka. Penerbit Kartu memiliki kartu, dan dapat membuat, mengeluarkan, dan memperbaruinya. Penerbit Kartu dapat berupa developer perorangan, perusahaan, dan organisasi, serta agregator yang membuat dan menerbitkan kartu atas nama orang lain, seperti perusahaan yang berspesialisasi dalam menerapkan tiket acara atau kupon untuk retailer.
Kelas Kartu
Kelas Kartu dapat dianggap sebagai template bersama yang digunakan untuk membuat kartu. Class Kartu menentukan properti tertentu yang akan disertakan dalam semua kartu yang menggunakannya. Penerbit Kartu dapat membuat beberapa class, masing-masing dengan kumpulan properti uniknya sendiri yang menentukan atribut seperti gaya dan tampilan, serta fitur tambahan seperti Smart Tap, serta Pendaftaran dan Login.
Pada umumnya, kartu dibuat dengan menyediakan Class Kartu untuk menentukan template kartu, dan Objek Kartu untuk menentukan spesifikasi setiap kartu yang diterbitkan.
Objek Kartu
Objek Kartu menentukan setiap kartu yang diberikan kepada pengguna untuk disimpan di Google Wallet mereka. Objek Pass sering berisi informasi khusus pengguna. Misalnya, meskipun Kelas Kartu dapat menentukan tampilan kartu voucher untuk toko tertentu, Objek Kartu akan memberikan detail spesifik seperti saldo atau tanggal habis masa berlaku.
Objek Kartu harus dibuat untuk setiap kartu yang dikeluarkan, bukan Class Kartu yang dapat dibagikan di banyak instance kartu.
Kartu pribadi
Beberapa kartu yang Anda buat dengan Google Wallet API dapat berisi data pengguna yang sensitif. Kartu-kartu ini memerlukan perlindungan tambahan untuk membantu menjaga keamanan data pengguna Anda dan dikelola secara berbeda di Google Wallet API menggunakan jenis Kartu Pribadi Umum. Kartu Pribadi Umum harus digunakan jika data sensitif (seperti yang ditentukan dalam Kebijakan Penggunaan yang Dapat Diterima Google Wallet API) disertakan dalam kartu Anda, dan mungkin harus melalui kontrol privasi dan peninjauan tambahan selama proses aktivasi.
Ketuk Cerdas
Smart Tap adalah protokol komunikasi nirkabel jarak dekat milik Google untuk menyampaikan data antara perangkat seluler dan terminal NFC. Teknologi Smart Tap memungkinkan pengguna menukarkan kartu yang disimpan di Google Wallet dengan mendekatkan ponsel ke terminal NFC yang kompatibel.
Untuk menggunakan protokol Smart Tap dengan kartu Anda, Anda harus menjalin hubungan dengan penyedia terminal yang mendukung Smart Tap.
API dan SDK
API Google Wallet
Google Wallet API adalah layanan yang disediakan oleh Google yang memungkinkan Anda membuat dan memberikan kartu untuk disimpan oleh pengguna di Google Wallet mereka. API ini dapat digunakan dengan beberapa cara, termasuk Google Wallet REST API, Google Wallet Android SDK, dan konsol Google Wallet.
REST API Google Wallet
Google Wallet REST API adalah antarmuka untuk membuat dan mengelola kartu secara terprogram dengan mengirimkan permintaan HTTP ke Google Wallet API.
Untuk menggunakan Google Wallet REST API, Anda juga memerlukan akun Google Cloud untuk membuat akun layanan, yang digunakan untuk mengautentikasi permintaan ke Google Wallet REST API.
Google Wallet Android SDK
Google Wallet Android SDK menyediakan serangkaian metode praktis untuk menggunakan Google Wallet API di aplikasi Android Anda, seperti membuat dan menerbitkan kartu.
Tambahkan ke Google Wallet
Tombol 'Tambahkan ke Google Wallet'
Tombol 'Tambahkan ke Google Wallet' adalah aset yang disetujui Google untuk menunjukkan kartu kepada pengguna. Saat pengguna mengklik atau mengetuk tombol tersebut, link 'Tambahkan ke Google Wallet' akan dipicu untuk memulai alur penambahan kartu yang diterbitkan ke Google Wallet pengguna.
Sebaiknya gunakan tombol 'Tambahkan ke Google Wallet' jika memungkinkan, karena ini adalah elemen UI yang sudah dikenal pengguna dan pengguna Anda sudah tahu cara berinteraksi dengannya.
Aset dan panduan untuk menggunakan tombol tersedia di Pedoman Merek Google Wallet API.
Link 'Tambahkan ke Google Wallet'
Dengan link 'Tambahkan ke Google Wallet', Anda dapat memberikan kartu kepada pengguna dengan hyperlink biasa. Ini dapat digunakan di mana pun Anda dapat menggunakan hyperlink, seperti email, SMS, situs web, dan aplikasi seluler.
Link 'Tambahkan ke Google Wallet' dibuat dengan menambahkan JWT yang ditandatangani ke URL https://pay.google.com/gp/v/save/.
Akun penerbit
Mode Demo
Saat Anda membuat akun Penerbit, akun tersebut akan berada dalam 'Mode Demo' hingga Anda disetujui untuk akses publikasi. Dalam mode demo, Anda dapat membuat kartu, tetapi Anda hanya dapat memberikannya kepada pengguna dengan peran 'Admin' atau 'Developer' di akun Penerbit Anda, atau pengguna yang telah ditambahkan sebagai akun pengujian di konsol Google Wallet.
Saat dalam 'Mode Demo', judul kartu yang Anda terbitkan akan otomatis dimulai dengan kata '[KHUSUS PENGUJIAN]' yang menunjukkan bahwa kartu tersebut hanya untuk tujuan pengujian.
Akun pengujian
Saat akun Penerbit dalam 'Mode Demo', jika ingin memberikan kartu kepada pengguna yang tidak memiliki peran 'Admin' atau 'Developer' untuk akun Anda, Anda harus menambahkannya sebagai akun pengujian di konsol Google Wallet. Pengguna yang terdaftar sebagai akun pengujian dapat menambahkan kartu yang Anda keluarkan ke Google Wallet mereka. Hal ini berguna untuk menguji kartu Anda dengan audiens yang lebih luas saat dalam 'Mode Demo'.
Profil bisnis
Guna membuat akun Penerbit untuk Google Wallet API, Anda harus menyiapkan profil bisnis saat mendaftar ke konsol Google Pay & Wallet. Profil bisnis memberi Google informasi dasar tentang perusahaan atau organisasi Anda, dan harus disetujui untuk mendapatkan akses publikasi.
Akses publikasi
Sebelum dapat memberikan kartu yang dapat disimpan oleh pengguna ke Google Wallet mereka, Anda harus disetujui untuk mendapatkan akses publikasi. Agar disetujui untuk akses publikasi, Anda harus membuat setidaknya satu Kelas Kartu, dan memiliki profil bisnis yang lengkap. Penerbit yang ingin menerbitkan kartu menggunakan Google Wallet Android SDK juga harus mengirimkan sidik jari SHA-1 untuk aplikasi mereka.
Untuk meminta akses publikasi, buka konsol Google Wallet dan klik tombol 'Minta Akses Publikasi'. Tim Google Wallet akan meninjau permintaan Anda dan memberi tahu setelah akses publikasi diberikan.
Autentikasi
JSON Web Token (JWT)
Token Web JSON adalah standar industri yang umum digunakan untuk mentransfer informasi sebagai objek JSON dengan aman. Saat menggunakan Google Wallet API, Anda mengenkode detail Objek Kartu yang ingin digunakan untuk membuat instance kartu dalam format JWT (diucapkan "jot"), lalu mengirimkan JWT tersebut dalam permintaan ke Google Wallet API.
JWT dijaga keamanannya dengan menandatanganinya dengan rahasia bersama sebelum dikirim ke Google Wallet API. Jika Anda menggunakan Google Wallet REST API, rahasia penandatanganannya adalah kunci akun layanan Google Cloud Anda. Jika Anda menggunakan Google Wallet Android SDK, rahasia penandatanganannya adalah sidik jari SHA-1 untuk aplikasi Android Anda.
Akun layanan
Akun layanan Google Cloud adalah jenis akun khusus yang biasanya digunakan oleh beban kerja aplikasi atau komputasi, bukan oleh orang. Dalam kasus Google Wallet API, akun layanan adalah akun yang akan Anda gunakan untuk mengautentikasi permintaan yang dikirim ke Google Wallet REST API.
Akun layanan dibuat di Konsol Google Cloud. Untuk menggunakan akun layanan, Anda juga perlu mengaktifkan Google Wallet API di Konsol Cloud agar akun layanan dapat membuat permintaan ke Google Wallet REST API.
Kunci akun layanan
Kunci akun layanan adalah kredensial yang akan Anda gunakan untuk mengautentikasi panggilan ke Google Wallet REST API. Kunci akun layanan dianggap sangat sensitif dan harus dirahasiakan, karena memberikan akses ke banyak fitur Penerbit Kartu di akun Anda menggunakan Google Wallet REST API, termasuk membuat Class Kartu dan Objek Kartu.
Sidik jari SHA-1
Sidik jari SHA-1 sertifikat penandatanganan aplikasi Android adalah kredensial yang akan Anda gunakan untuk mengautentikasi panggilan ke Google Wallet API saat Anda menggunakan Google Wallet Android SDK. Sidik jari SHA-1 sertifikat Anda dihasilkan menggunakan Gradle atau keytool. Agar dapat menggunakan sidik jari untuk mengautentikasi permintaan, Anda harus mendaftarkannya di konsol Google Wallet.