Ana içeriğe geç

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 6 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.

GETinstallment/v1/installments

İ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.

binNumber
number

Taksit sorgulama yapılacak olan kartın ilk 6 hanesi. Eğer gönderilmezse tüm taksitler dönülür. Gönderilirse eğer sadece bin numarasına ait kart ailesinin taksit sayıları dönülür
19.04.2022 14:00 tarihinde yapılacak olan 8 haneli bin geçişi sonrası 8 hane olarak gönderilmelidir

price
decimal
zorunlu

Fiyat

currency
Currency

Taksit sorgulama işleminin hangi kur için yapılacağı. bkz: Para Birimleri

Değerler:
TRY
USD
EUR
GBP
CNY
ARS
BRL
AED
IQD
AZN
KZT
distinctCardBrandsWithLowestCommissions
boolean

Taksit sorgulama sonucunda aynı kart ailesine ait birden fazla sonuç oluşması durumunda en düşük komisyona göre tekilleştirilmesi için kullanılır.

loyaltyExists
boolean

Ö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.

paymentPhase
PaymentPhase

Eğer ödeme işlemi ön provizyon ile gerçekleştirilecekse bu değer PRE_AUTH olarak iletilmelidir. bkz: Ödeme Fazları

Değerler:
AUTH
PRE_AUTH
POST_AUTH

Dönüş Parametreleri

binNumber
string

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

price
decimal

Fiyat

cardType
CardType
Değerler:
CREDIT_CARD
DEBIT_CARD
PREPAID_CARD
cardAssociation
CardAssociation

Kart Kuruluşu

Değerler:
VISA
MASTER_CARD
AMEX
TROY
JCB
UNION_PAY
MAESTRO
DISCOVER
DINERS_CLUB
cardBrand
string

Kart ailesi

bankName
string

Kartın bağlı olduğu banka ismi

bankCode
number

Banka kodu

force3ds
boolean

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.

cvcRequired
boolean

Ö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.

commercial
boolean

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.

installmentPrices
InstallmentPrice[]

Her taksit seçeneği için fiyat bilgisini barındıran obje listesi

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.

Loading..