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
| Method | Endpoint | Body |
|---|---|---|
| GET | /external/vpos/v1/installments?binCode=45467100&amount=100.00 | - |
Query Parametreleri
| Alan | Tip | Zorunlu | Açı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
| Alan | Tip | Açıklama |
|---|---|---|
| message | string | Sonuç mesajı |
| content | object | Taksit listesi içeriği |
Cevap İçeriği Parametreleri
| Alan | Tip | Açı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
| Alan | Tip | Açı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.
