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 kartın eklendiğini belirten açıklamanın yer aldığı 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:

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

Otomatik Bağlı Kartları kullanırken dikkat edilmesi gereken bazı 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 gönderilmesi garanti edilmez ve mümkün olduğunca gönderildiği kabul edilir. Kullanıcılar, otomatik bağlı kartları almayı devre dışı bırakabilir. Kullanım alanı önemliyse ve kullanıcının bağlı kartı alması gerekiyorsa kullanıcının kartı eklediğinden emin olmak için başka bir kanal üzerinden iletişim kurmanızı ö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ı

Zaten birincil 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 linkedObjectIds'i ayarlamak için minimum bir 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ı veren kimliğini paylaşmıyor.	Başka bir verenin nesnesine bağlı nesne ekleyemezsiniz.
Birincil nesne ve bağlı nesne aynı nesneye başvuruda bulunuyor.	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.
Daha fazla bağlı nesne eklenemiyor, sınır aşıldı.	Birincil kart için 50 bağlı kart sınırına ulaşıldı.