Kartu Tertaut Otomatis

Latar belakang

Fitur Kartu yang Ditautkan Otomatis memungkinkan Anda mengirim kartu tambahan ke pengguna yang sudah memiliki kartu Anda di Google Wallet-nya. Anda juga dapat pra-link diteruskan ke kartu utama saat pengguna menyimpan kartu utama {i>pass <i}(utama). Kartu Tertaut Otomatis dikelompokkan dengan kartu utama dengan info di atas kartu utama yang memberi tahu pengguna bahwa kartu baru telah ditautkan. Jenis kartu berikut didukung sebagai kartu utama atau kartu tertaut;

  • Tiket acara
  • Tiket pesawat
  • Tiket transportasi umum
  • Penawaran
  • Kartu hadiah
  • Kartu loyalitas
  • Kartu umum
Contoh Utama Kartu yang Ditautkan Otomatis Contoh Sekunder Kartu yang Ditautkan Otomatis
Kartu utama dengan info bahwa kartu baru telah ditambahkan Kartu baru yang ditautkan ke kartu utama

Kasus Penggunaan

Anda mungkin memiliki kasus penggunaan yang berbeda untuk menautkan kartu ke kartu yang sudah ada. Agak besar contohnya meliputi:

  • Tautkan penawaran ke kartu loyalitas yang ada.
  • Tautkan voucher makanan ke boarding pass atau tiket acara.
  • Menautkan kartu parkir ke tiket acara.

Beberapa pertimbangan saat menggunakan Kartu Tertaut Otomatis

  • Objek utama dan objek tertaut harus menggunakan penerbitId yang sama.
  • Ada batas 50 objek tertaut per objek utama.
  • Mendorong kartu tertaut secara otomatis tidak dijamin dan dipertimbangkan upaya terbaik. Pengguna dapat memilih untuk tidak menerima Kartu Tertaut Otomatis. Jika kasus penggunaannya adalah penting dan pengguna harus menerima kartu yang ditautkan, sebaiknya berkomunikasi melalui saluran lain untuk memastikan pengguna menambahkan kartu.
  • Pembaruan pada AUP Google Wallet mencakup panduan tentang penggunaan Kartu Tertaut Otomatis yang harus dipatuhi.

Langkah-Langkah Integrasi

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

  1. Buat objek dari semua jenis kartu yang tercantum dengan parameter yang diperlukan. Ini adalah objek utama.
  2. Buat objek lain dari jenis kartu apa pun yang tercantum. Tujuan ini akan menjadi linked.
  3. Sebelum atau setelah objek utama disimpan, update objek utama dengan ID objek yang ditautkan di linkedObjectIds .

Ada payload minimum yang diperlukan untuk menetapkan linkedObjectIds di alamat IP lulus. 3 parameter yang diperlukan meliputi;

  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 pass

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

Perilaku yang diharapkan

Setelah menerima respons berhasil, perangkat dengan kartu yang Anda perbarui yang akan menerima kartu yang ditautkan. Kartu yang tertaut ini akan dikelompokkan bersama dengan {i>primary pass<i}. Pengguna dapat melihat kartu yang ditautkan dengan menggeser ke kanan.

Penanganan pengecualian

Potensi kesalahan bisa terjadi dengan penggunaan API yang salah yang dapat termasuk;

Kirim pesan Alasan
Objek utama dan objek tertaut tidak memiliki penerbit yang sama ke ID. Anda tidak dapat melampirkan objek yang ditautkan ke objek penerbit lain.
Objek utama dan objek tertaut merujuk ke objek yang sama. Anda tidak dapat melampirkan objek yang sama seperti linkedObject.
Objek yang ditautkan tidak ada. Objek yang ditautkan harus sudah dimasukkan ke dalam Wallet Compute Engine API.
Objek tertaut sudah memiliki objek tertaut lain. Tidak dapat menambahkan item bertingkat objek tertaut. Objek tertaut tidak boleh memiliki objek tertaut lain.
Objek sudah ditautkan ke objek lain. Tidak dapat menambahkan link bertingkat objek terstruktur dalam jumlah besar. Objek utama tidak dapat menjadi objek tertaut dengan sendirinya.
Tidak dapat menambahkan objek tertaut lagi, batas terlampaui. Batas 50 kartu tertaut telah tercapai untuk kartu utama lulus.