Menambahkan Kartu Boarding secara Otomatis

Latar belakang

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

Hal ini terjadi secara otomatis, terlepas dari saluran check-in (misalnya, web, aplikasi, atau kios di bandara). Maskapai menggunakan nomor akun program loyalitas pengguna untuk mengorelasikan dan mengirimkan kartu.

Catatan: Fitur ini adalah penerapan khusus dari kemampuan "Kartu yang Ditautkan Otomatis". Bagian dokumen lainnya menggunakan terminologi yang lebih luas, yaitu "Kartu yang Ditautkan Otomatis", serta "kartu utama" dan "kartu yang ditautkan" untuk mendeskripsikan fungsi ini.

Cara kerja fitur ini

Langkah 1: Aktifkan pelanggan setia untuk menambahkan kartu loyalitas mereka ke Wallet.

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

Beberapa pertimbangan saat menggunakan Kartu yang Ditautkan Otomatis

• Objek utama dan objek tertaut harus menggunakan issuerId yang sama.
• Ada batas 50 objek tertaut per objek utama.
• Pengiriman 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.
• Perubahan 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 objek dari 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 yang ditautkan.
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"
  }
  …

Perilaku yang diharapkan

Setelah menerima respons yang berhasil, perangkat dengan kartu yang Anda perbarui akan menerima kartu tertaut. Kartu yang ditautkan ini akan dikelompokkan bersama kartu utama. Pengguna dapat melihat kartu yang ditautkan dengan menggeser ke kanan.

Penanganan pengecualian

Potensi error dapat terjadi karena penggunaan API yang salah, yang dapat mencakup: