Kartu Tertaut Otomatis

Latar belakang

Fitur Kartu Tertaut Otomatis memungkinkan Anda mengirim kartu tambahan kepada pengguna yang sudah memiliki kartu Anda yang ada di Google Wallet mereka. Anda juga dapat melakukan pra-penautan 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 hadiah
• Kartu loyalitas
• Kartu umum

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 ada. Beberapa 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 yang Terhubung Otomatis

• Objek utama dan objek tertaut harus menggunakan issuerId yang sama.
• Ada batas 50 objek tertaut per objek utama.
• Meneruskan kartu tertaut secara otomatis tidak dijamin dan dianggap sebagai upaya terbaik. Pengguna dapat memilih untuk tidak menerima Kartu yang ditautkan Otomatis. Jika kasus penggunaannya penting dan pengguna harus menerima kartu yang ditautkan, sebaiknya komunikasikan 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 objek dari jenis kartu 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 tertaut.
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 kartu utama. 3 parameter yang diperlukan 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 berhasil, perangkat dengan kartu yang Anda perbarui akan menerima kartu tertaut. Kartu tertaut ini akan dikelompokkan bersama dengan kartu utama. Pengguna dapat melihat kartu yang ditautkan dengan menggeser ke kanan.

Penanganan pengecualian

Kemungkinan error dapat terjadi dengan 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 dengan linkedObject.
Objek tertaut tidak ada.	Objek tertaut seharusnya sudah disisipkan ke Wallet API.
Objek tertaut sudah memiliki objek tertaut lain. Tidak dapat menambahkan objek tertaut 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 menjadi objek tertaut dengan sendirinya.
Tidak dapat menambahkan objek tertaut lagi, batas terlampaui.	Batas 50 kartu tertaut telah tercapai untuk kartu utama.