TahsilatE Logo
Geliştirici Ortamı

Taksit Listeleme

Bu servisi kullanarak kart bin kodu ile taksit listesi alabilirsiniz. Kullanıcı kart numarasını girdiğinde taksitleri görüntülemesini sağlayabilirsiniz.

Taksit Listeleme Servisi İstek Modeli

MethodEndpointBody
GET/external/vpos/v1/installments?binCode=45467100&amount=100.00-

Query Parametreleri

AlanTipZorunluAçıklama
binCode
string
Evet
Kartın ilk 6-8 hanesi. 8 hane kartı kesin olarak belirler; ödeme de kartın ilk 8 hanesine göre değerlendirilir.
amount
number
Hayır
Ödeme tutarı, en fazla 2 ondalık. Gönderilirse tutar sınırına uymayan taksitler listeden çıkarılır ve kampanya bu tutara göre verilir. Gönderilmezse tutar alanları 0 döner.
showAllInstallments
boolean
Hayır
Kart banka kartı veya ön ödemeli kart görünse de tüm taksitleri listeler. Kart sahibi taksitleri kendisi açmak istediğinde true gönderin. Varsayılan false.

Cevap Parametreleri

AlanTipAçıklama
message
string
Sonuç mesajı
content
object
Taksit listesi içeriği

Cevap İçeriği Parametreleri

AlanTipAçıklama
bankName
string
Banka adı
Örnek:Yapı ve Kredi Bankası
cardProgramName
string
Kart program adı
Örnek:World
bankImage
string
Banka logosu
Örnek:/storage/images/banks/yapi-ve-kredi-bankasi.png
cardProgramImage
string
Kart program logosu
Örnek:/storage/images/card-programs/world.png
isUndefined
boolean
Banka tanımsız ise true
Örnek:false
cardType
string | null
Kart tipi: credit (kredi kartı), debit (banka kartı), prepaid (ön ödemeli kart). Bilinmiyorsa null.
Örnek:credit
singlePaymentSuggested
boolean
Kart banka kartı veya ön ödemeli kart görünüyorsa true. Bu durumda showAllInstallments gönderilmedikçe yalnızca tek çekim listelenir.
Örnek:false
installments[]
array
Taksit bilgileri listesi

Taksit Bilgileri Parametreleri

AlanTipAçıklama
installment
number
Taksit sayısı
merchantCommission
number
Üye işyeri komisyon oranı
customerCommission
number
Müşteri komisyon oranı
commissionOption
string
Komisyon seçeneği
amountPerInstallment
number
Her taksit için ödeme tutarı
totalAmount
number
Toplam ödeme tutarı
netAmount
number
Üye işyerine yatacak tutar
minAmount
number
Minimum taksit tutarı
maxAmount
number
Maksimum taksit tutarı
campaign
string
Kampanya içeriği (örn: +3). amount gönderildiyse yalnızca bu tutara uygulanacak kampanya döner, uygulanmıyorsa boştur.
campaignMinAmount
number
Kampanya minimum tutarı
campaignMaxAmount
number
Kampanya maksimum tutarı

Tanımlı Banka Cevabı

Başarılı Cevap Örneği

Tanımlı bir banka için taksit listesi

123456789101112131415161718192021222324252627282930313233343536373839

Tanımsız Banka Cevabı

Tanımsız Banka Cevabı

Tanımlanamayan banka için varsayılan taksit listesi

12345678910111213141516171819202122232425
Kartın bankası tanımlı değilse isUndefined: true döner. Komisyon oranları ve netAmount 0'dır, taksitler üye işyerinin varsayılan banka ayarlarındaki aralıkla sınırlıdır.

Banka Kartı ve Ön Ödemeli Kartlar

Kart tipi BKM'nin resmi BIN listesinden okunur. Kart banka kartı veya ön ödemeli kart görünüyorsa singlePaymentSuggested: true döner ve varsayılan olarak yalnızca tek çekim listelenir.

  • Bu bir engel değildir. BKM verisi bankaların bildirimlerine dayanır ve nadiren hatalı olabilir; kart sahibi kartının kredi kartı olduğunu söylerse aynı isteği showAllInstallments=true ile tekrarlayıp tüm taksitleri gösterebilirsiniz.
  • Taksitli ödeme isteği reddedilmez. Kart gerçekten banka kartıysa işlemi kartın bankası reddeder.
  • Müşteriye taksitleri açtırırken kartı banka kartıysa işlemin reddedilebileceğini belirtmenizi öneririz.

Tutar Hesaplama

amount gönderildiğinde her taksit için tutarlar şöyle hesaplanır (2 ondalığa yuvarlanır):

  • commissionOption = CUSTOMER: komisyonu kart sahibi öder. totalAmount = amount + amount × customerCommission / 100, netAmount = amount.
  • commissionOption = MERCHANT: komisyonu üye işyeri öder. totalAmount = amount, netAmount = amount − amount × merchantCommission / 100.
  • amountPerInstallment = totalAmount / installment.
CUSTOMER seçeneğinde vade farkını ödeme kuruluşu ekler ve kart sahibinden totalAmount çekilir. Ödeme isteğinde amount olarak her zaman komisyonsuz tutarı gönderin; totalAmount'u gönderirseniz vade farkı iki kez eklenir. Müşteriye ödemeden önce totalAmount'u gösterin. Ödeme sayfası (checkout) bunu kendisi gösterir.