Taksit Sorgulama
Taksit sorgulama servisinin sonucunda kart ailelerine ait taksitli ve tek çekim ödenecek tutarlar dönülür ve bu tutar ödeme servisi paidPrice ve installment parametreleri ile beraber kullanılmalıdır.
Servis eğer bin numarası girilerek kullanılmak isteniyorsa ödeme sayfasında kartın ilk 8 hanesi girildikten sonra çağırılması gerekmektedir. Dönen cevabın ise kullanıcıya taksit seçimi için gösterilmesinde kullanılır. Servisten dönen taksit seçenekleri, üye işyeri panelindeki pos yönetimi alanındaki bilgiler ile ilişkilidir.
URL
Taksit sorgulama için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.
İstek Parametreleri
Taksit sorgulama işlemi gerçekleştirmek için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.
Taksit sorgulaması yapılacak olan kartın ilk 8 hanesi.
- Bu parametre iletilirse, yalnızca belirtilen BIN numarasına ait kart ailesi için taksit seçenekleri dönüşü yapılır.
- İletilmezse, ekli POS'larınızın desteklediği tüm kart ailelerine ait taksit seçenekleri dönüşü yapılır.
Fiyat
Taksit sorgulama işleminin hangi kur için yapılacağı. bkz: Para Birimleri
Bir kart ailesi için birden fazla sonuç oluşması durumunda, üye işyeri POS yönlendirme kuralları dikkate alınarak kart ailesi bazlı tekilleştirme yapılır.
Bu parametre true iletiğinde, binNumber parametresi iletilmiyorsa yanıt içerisinde bankCode ve bankName alanları dönülmez.
Ödeme adımında ödül/puan kullanımı varsa yada olacaksa bu parametre ile ödül/puan destekleyen bankalara ait taksitlerin dönülmesi için kullanılır.
Eğer ödeme işlemi ön provizyon ile gerçekleştirilecekse bu değer PRE_AUTH olarak iletilmelidir. bkz: Ödeme Fazları
Dönüş Parametreleri
Taksit sorgulama yapılan kartın ilk 6 hanesi.
19.04.2022 14:00 tarihinde yapılacak olan 8 haneli bin geçişi sonrası, 8 hane olarak dönecektir
Fiyat
Kart Kuruluşu
Kart ailesi
binNumber parametresi iletiliyor ise, kartın bağlı olduğu banka ismi.
binNumber parametresi iletilmiyor ise ve distinctCardBrandsWithLowestCommissions parametresi false ise ilgili Sanal POSun bağlı olduğu banka ismi.
binNumber parametresi iletilmiyor ise ve distinctCardBrandsWithLowestCommissions parametresi true ise bu alan dönülmez.
binNumber parametresi iletiliyor ise, kartın bağlı olduğu banka kodu.
binNumber parametresi iletilmiyor ise ve distinctCardBrandsWithLowestCommissions parametresi false ise ilgili Sanal POSun bağlı olduğu banka kodu.
binNumber parametresi iletilmiyor ise ve distinctCardBrandsWithLowestCommissions parametresi true ise bu alan dönülmez.
3ds ödeme zorunluluğu olup olmadığı bilgisi. Kullanılan kart debit ise ve üye işyeri panelinden ilgili pos için 3dsecure zorunluluğu girilmiş ise true döner. Eğer true dönmüş ise ödeme 3dsecure yapılmalıdır.
Ödeme yapılırken cvc gönderilmesi zorunlu mu? Üye işyeri posu eğer cvcsiz işleme açık değilse true döner.
Ticari kart olup olmadığı bilgisi. Gıda gibi, bireysel kartlara taksit kullanımı yasak olan bir ürün sepete eklenmiş ise, commercial parametresini kontrol etmelisiniz. false döndüğünde taksit yapmamalısınız. Eğer kullanılan kart ticari bir kart ise bu parametre true dönecektir. Ticari kartlara taksit yapmak serbest olduğu için kullanıcıya taksit sunulabilir.
Her taksit seçeneği için fiyat bilgisini barındıran obje listesi
İki farklı senaryoda taksit seçeneklerini optimize edilmiş şekilde listeyebilirsiniz:
-
Tüm kart ailelerine ait taksit seçeneklerini listelemek için:
- distinctCardBrandsWithLowestCommissions: true
- binNumber parametresi kullanmayın
- Böylece kart ailesi bazlı taksit seçeneklerini listeleyebilirsiniz
-
Ödeme adımında girilen karta ait taksit seçeneklerini listelemek için:
- distinctCardBrandsWithLowestCommissions: true
- binNumber parametresine kullanıcının kart numarasının ilk 8 hanesini gönderin
- Bu sayede kullanıcının kartına özel geçerli taksit seçeneklerini listeleyebilirsiniz
Örnek Kodlar
Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.