Temassız Kart

Temassız kart, cüzdan kullanıcılarınızın fiziksel bir kartla ödeme ve geçiş yapabilmesini sağlar. Kart bir cüzdan kullanıcısına, yani user_mapping_id değerine tanımlanır. Kartla yapılan harcamalar o kullanıcının cüzdanından düşer.

Bir kullanıcıya birden fazla kart tanımlanabilir, kartları ayırt etmek için name alanı kullanılabilir.

Üç servis bulunur: kart tanımlama, kart listeleme ve kart iptali.

Tipik Akış

1) Kart tanımlama

Kullanıcı kartın üzerindeki numarayı uygulamanıza girer. Uygulamanızın sunucusu kart tanımlama servisini çağırır ve kart numarasını, kullanıcı linkleme id değerini, isterse kart etiketini gönderir.

2) Kart değişimi

Kart kaybolduğunda veya yenilendiğinde önce eski kart iptal edilir, ardından yeni kart tanımlanır. Kullanıcının hangi kartlarının aktif olduğunu kart listeleme servisiyle görebilirsiniz.

3) Toplu iptal

Kartların topluca toplandığı durumlarda tek istekte en fazla 50 kart iptal edilebilir.

Kısmi Başarı

Tanımlama ve iptal servisleri listedeki kartları tek tek işler. Bir kart işlenemezse istek başarısız olmaz, o kart fails listesinde sebebiyle birlikte döner, diğer kartlar işlenmeye devam eder.

Yanıttaki success_count kaç kartın işlendiğini, fails hangi kartların neden işlenemediğini gösterir.

{
  "data": {
    "success_count": 48,
    "fails": [
      { "card_no": "5E6F7G8H", "message": "Kart bulunamadı." },
      { "card_no": "9I0J1K2L", "message": "Kart zaten tanımlı, lütfen başka kart deneyiniz." }
    ]
  }
}

İptalin Etkisi

Kart iptal edildiğinde yalnızca kart pasife alınır.

• Kullanıcının cüzdan bakiyesine dokunulmaz.
• Kartın depozitosu varsa iade edildi olarak kapatılır, tutar cüzdana yüklenmez. İptal sebebi lost ise depozito iade edilmez.
• Karta tanımlı harcama limiti varsa kaldırılır.

İptal edilen kart bir daha kullanılamaz. Aynı kart numarası daha sonra yeni bir kayıt olarak yeniden tanımlanabilir.