Kartu Tertaut Otomatis

Latar belakang

Fitur Kartu Ditautkan Otomatis memungkinkan Anda mengirim kartu tambahan kepada pengguna yang sudah memiliki kartu Anda di Google Wallet mereka. Anda juga dapat melakukan pra-link kartu ke kartu utama saat pengguna menyimpan kartu utama (utama). Kartu yang Ditautkan 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 tertaut;

  • Tiket acara
  • Tiket pesawat
  • Tiket multi-trip
  • Penawaran
  • Kartu voucher
  • Kartu loyalitas
  • Kartu umum

Kasus Penggunaan

Anda mungkin memiliki kasus penggunaan yang berbeda untuk menautkan kartu ke kartu yang sudah ada. Beberapa contohnya antara lain:

  • Menautkan penawaran ke kartu loyalitas yang sudah 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 publisherId yang sama.
  • Ada batas 50 objek tertaut per objek utama.
  • Mengirim kartu tertaut secara otomatis tidak dijamin dan dianggap sebagai upaya terbaik. Pengguna dapat memilih untuk tidak menerima Kartu Tertaut Otomatis. Jika kasus penggunaan penting dan pengguna harus menerima kartu yang ditautkan, sebaiknya berkomunikasi melalui saluran lain untuk memastikan pengguna menambahkan kartu.
  • Pembaruan pada AUP Google Wallet menyertakan 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 jenis penerusan apa pun yang tercantum dengan parameter yang diperlukan. Ini adalah objek utama.
  2. Buat objek lain dari jenis kartu apa pun yang tercantum. Ini akan menjadi objek ditautkan.
  3. Sebelum atau setelah objek utama disimpan, perbarui objek utama dengan ID objek tertaut dalam parameter linkedObjectIds.

Ada payload minimum yang diperlukan untuk menetapkan linkedObjectIds pada penerusan utama. Tiga 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 kartu

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

Perilaku yang diharapkan

Setelah menerima respons yang berhasil, perangkat dengan kartu yang diperbarui akan menerima kartu yang ditautkan. Kartu tertaut ini akan dikelompokkan bersama dengan 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 menyertakan;

Kirim pesan Alasan
Objek utama dan objek tertaut tidak menggunakan ID penerbit yang sama. 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 dengan linkedObject.
Objek tertaut tidak ada. Objek tertaut seharusnya sudah dimasukkan ke dalam Wallet API.
Objek tertaut sudah memiliki objek tertaut lain. Tidak dapat menambahkan objek tertaut. Objek tertaut tidak boleh memiliki objek tertaut lain.
Objek sudah ditautkan ke objek lain. Tidak dapat menambahkan objek tertaut bertingkat. Objek utama tidak boleh berupa objek yang tertaut dengan sendirinya.
Tidak dapat menambahkan objek tertaut lagi, batas terlampaui. Batas 50 kartu tertaut telah tercapai untuk kartu utama.