Kartu Tertaut Otomatis

Latar belakang

Fitur Kartu yang Ditautkan Otomatis memungkinkan Anda mengirim kartu tambahan kepada pengguna yang sudah memiliki kartu Anda di Google Wallet mereka. Anda juga dapat menautkan kartu secara awal 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 kartu tertaut;

• Tiket acara
• Boarding pass
• Tiket transportasi umum
• Penawaran
• Kartu hadiah
• Kartu loyalitas
• Kartu generik

Kartu utama dengan info bahwa kartu baru telah ditambahkan	Kartu baru ditautkan ke kartu utama

Kasus Penggunaan

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

• Tautkan 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 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 izin 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

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