Otomatik Olarak Bağlanan Kartlar

Arka plan

Otomatik Bağlı Kartlar özelliği, mevcut kartınızı Google Cüzdan'ında bulunduran bir kullanıcıya ek kartlar göndermenize olanak tanır. Kullanıcı birincil (ana) geçişi kaydettiğinde geçişleri birincil geçişe önceden bağlayabilirsiniz. Otomatik olarak bağlanan kart, birincil kartla gruplandırılır. Birincil kartın üzerinde, kullanıcıyı yeni bir kartın bağlandığı konusunda bilgilendiren bir açıklama metni bulunur. Aşağıdaki geçiş türleri birincil veya bağlı geçiş olarak desteklenir:

• Etkinlik bileti
• Uçuş kartı
• Toplu taşıma kartı
• Teklif
• Hediye kartı
• Bağlılık kartı
• Genel kart

Yeni bir kartın eklendiğini belirten açıklama metni içeren birincil kart	Birincil karta bağlı yeni kart

Kullanım Alanları

Kartları mevcut bir karta bağlamak için farklı kullanım alanlarınız olabilir. Buna örnek olarak aşağıdakiler verilebilir:

• Bir teklifi mevcut bir bağlılık kartına bağlama
• Yemek kuponu bir biniş kartına veya etkinlik biletine bağlanabilir.
• Bir park kartını etkinlik biletine bağlayabilirsiniz.

Otomatik olarak bağlanan kartları kullanırken dikkat edilmesi gereken noktalar

• Birincil nesne ve bağlı nesne aynı refundId değerini kullanmalıdır.
• Birincil nesne başına 50 bağlı nesne sınırı vardır.
• Bağlı kartların otomatik olarak aktarılması garanti edilmez ve en iyi çaba olarak kabul edilir. Kullanıcılar, otomatik bağlı kartları almayı devre dışı bırakabilir. Kullanım alanı kritikse ve kullanıcının bağlı geçişi alması gerekiyorsa kullanıcının geçişi eklediğinden emin olmak için başka bir kanal üzerinden iletişime geçmenizi öneririz.
• Google Cüzdan AUP'de yapılan güncellemeler, uyulması gereken Otomatik Bağlı Kartların kullanımıyla ilgili yönergeler içerir.

Entegrasyon Adımları

Daha önce birincil bir nesne oluşturduysanız 1. adımı atlayabilirsiniz.

1. Gerekli parametrelerle listelenen herhangi bir geçiş türünde bir nesne oluşturun. Bu, birincil nesnedir.
2. Listelenen herhangi bir kart türünde başka bir nesne oluşturun. Bu, bağlı nesne olacaktır.
3. Birincil nesne kaydedilmeden önce veya sonra, birincil nesneyi linkedObjectIds parametresindeki bağlı nesnenin kimliğiyle güncelleyin.

Birincil geçişte linkedObjectId’leri ayarlamak için gereken minimum yük vardır. Zorunlu olan 3 parametre şunlardır:

1. ISSUERID.PRIMARY_OBJECT_ID
2. ISSUERID.PRIMARY_CLASS_ID
3. ISSUERID.LINKED_OBJECT_ID

Geçiş nesnesine bağlı bir nesne eklemek için örnek JSON isteği

  …
  {
    "id": "ISSUERID.PASS_OBJECTID",
    "classId": "ISSUERID.PASS_CLASSID",
    "barcode": {
      "type": "qrCode",
      "value": "QR code"
    },
    "linkedObjectIds": {"ISSUERID.LINKED_PASS_OBJECTID"}
  }
  …

Bir nesneyi geçiş nesnesine bağladıktan sonra örnek JSON yanıtı

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

Beklenen davranış

Başarılı bir yanıt aldıktan sonra, güncellediğiniz kartın bulunduğu cihazlara bağlı kartı alırlar. Bu bağlı geçiş, birincil geçişle birlikte gruplandırılır. Kullanıcılar sağa kaydırarak bağlı kartı görebilir.

İstisna işleme

API'nin yanlış kullanımıyla ilgili olası hatalar şunlardır:

Mesaj	Nedeni
Birincil nesne ve bağlı nesne, aynı düzenleyen kimliğini paylaşmaz.	Bağlı bir nesneyi başka bir verenin nesnesine ekleyemezsiniz.
Birincil nesne ve bağlı nesne aynı nesneyi ifade eder.	linkedObject ile aynı nesneyi ekleyemezsiniz.
Bağlı nesne mevcut değil.	Bağlı nesne, Cüzdan API'sine zaten eklenmiş olmalıdır.
Bağlı nesnenin zaten başka bir bağlı nesnesi var. İç içe yerleştirilmiş bağlı nesneler eklenemez.	Bağlı nesnelerin başka bir bağlı nesnesi olamaz.
Nesne zaten başka bir nesneye bağlı. İç içe yerleştirilmiş bağlı nesneler eklenemez.	Birincil nesne kendi başına bağlı bir nesne olamaz.
Sınır aşıldığı için daha fazla bağlı nesne eklenemiyor.	Birincil kart için 50 bağlı kart sınırına ulaşıldı.