Menambahkan Kartu Boarding secara Otomatis

Latar belakang

Fitur ini memungkinkan maskapai penerbangan mengirimkan kartu boarding secara otomatis ke Google Wallet pengguna. Fitur ini akan sangat bermanfaat bagi penumpang yang sering bepergian karena mereka akan menikmati metode yang lebih sederhana dan lancar untuk menambahkan kartu boarding ke Wallet mengingat frekuensi perjalanan mereka yang lebih tinggi.

Hal ini terjadi secara otomatis, terlepas dari saluran check-in (misalnya, web, aplikasi, atau kios bandara). Partner maskapai penerbangan dapat menggunakan nomor akun loyalitas pengguna untuk mengorelasikan dan mengirimkan kartu ke Wallet mereka.

Cara kerja fitur ini

Langkah 1: Aktifkan penumpang setia untuk menambahkan kartu loyalitas program frequent flyer ke Wallet.

Langkah 2: Tambahkan boarding pass baru secara otomatis untuk penumpang setia dengan menautkannya ke kartu loyalitas di Wallet.

Praktik terbaik

• Untuk mengaktifkan pendaftaran program loyalitas yang lancar bagi penumpang yang sering terbang, pertimbangkan untuk mengaktifkan alur Daftar / Login dengan Google. Pengguna kemudian dapat menemukan alur pendaftaran program loyalitas maskapai penerbangan Anda di berbagai titik entri di Google Wallet, termasuk boarding pass.
• Pertimbangkan untuk mengaktifkan pendaftaran sekali klik bagi anggota program loyalitas yang sudah ada di aplikasi dan situs Android Anda.

Catatan: Fitur ini adalah penerapan khusus dari kemampuan Kartu yang Ditautkan Otomatis. Dalam konteks ini, kartu utama merujuk pada kartu loyalitas dan kartu tertaut merujuk pada boarding pass. Bagian selanjutnya dari dokumen ini menggunakan terminologi yang lebih luas—Kartu Tertaut Otomatis, kartu utama, dan kartu tertaut—untuk mendeskripsikan fungsi ini.

Beberapa pertimbangan saat menggunakan Kartu yang Ditautkan Otomatis

• Objek utama dan objek tertaut harus menggunakan issuerId yang sama.
• Mendorong kartu tertaut secara otomatis tidak dijamin dan dianggap sebagai upaya terbaik. Pengguna dapat memilih untuk tidak menerima Kartu yang Ditautkan Otomatis. Jika kasus penggunaan bersifat kritis dan pengguna harus menerima kartu tertaut, sebaiknya berkomunikasi melalui saluran lain untuk memastikan pengguna menambahkan kartu.
• Pembaruan pada AUP Google Wallet mencakup panduan tentang penggunaan Kartu yang Ditautkan Otomatis yang harus dipatuhi.

Langkah-langkah integrasi

Jika sudah membuat objek utama, Anda dapat melewati langkah 1.

1. Buat object jenis kartu apa pun yang tercantum dengan parameter yang diperlukan. Ini adalah objek utama.
2. Buat objek lain dari jenis kartu yang tercantum. Objek ini akan menjadi objek tertaut.
3. Sebelum atau setelah objek utama disimpan, perbarui objek utama dengan ID objek tertaut dalam parameter linkedObjectIds.

Ada payload minimum yang diperlukan untuk menyetel linkedObjectIds pada kartu utama. 3 parameter wajib mencakup;

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Contoh Permintaan JSON untuk menambahkan objek tertaut ke objek kartu

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": ["ISSUERID.LINKED_PASS_OBJECTID"]
  }
  …

Contoh Respons JSON setelah menautkan objek ke objek kartu

  …
  "state": "active",
  "linkedObjectIds": {
    "ISSUERID.LINKED_PASS_OBJECTID"
  }
  …

Penanganan pengecualian

Error potensial dapat terjadi karena penggunaan API yang salah, yang dapat mencakup:

Kirim pesan	Alasan
Objek utama dan objek tertaut tidak memiliki ID penerbit yang sama.	Anda tidak dapat melampirkan objek tertaut ke objek penerbit lain.
Objek utama dan objek tertaut merujuk ke objek yang sama.	Anda tidak dapat melampirkan objek yang sama sebagai linkedObject.
Objek tertaut tidak ada.	Objek tertaut harus sudah dimasukkan ke dalam Wallet API.
Objek tertaut sudah memiliki objek tertaut lain. Tidak dapat menambahkan objek tertaut yang bertingkat.	Objek tertaut tidak boleh memiliki objek tertaut lain.
Objek sudah ditautkan ke objek lain. Tidak dapat menambahkan objek tertaut bertingkat.	Objek utama tidak dapat berupa objek tertaut dengan sendirinya.