Installments (Taksit)

Taksit sorgulama, müşterinin kartına uygun taksit seçeneklerini öğrenmenizi sağlar. BIN numarasına göre banka ve taksit bilgileri döner.

Taksit Sorgulama

Kart numarasının ilk 6 veya 8 hanesini (BIN) göndererek taksit seçeneklerini sorgulayın:

POST /api/v1/payment/installment

{
  "session_id": "ses_xxx",
  "bin_number": "538888",
  "amount": 15000
}

Yanıt

{
  "success": true,
  "bank_name": "Garanti BBVA",
  "card_brand": "mastercard",
  "card_type": "credit",
  "installments": [
    { "count": 1, "total_amount": 15000, "installment_amount": 15000, "commission_rate": 0 },
    { "count": 3, "total_amount": 15450, "installment_amount": 5150, "commission_rate": 3.0 },
    { "count": 6, "total_amount": 15900, "installment_amount": 2650, "commission_rate": 6.0 },
    { "count": 9, "total_amount": 16350, "installment_amount": 1817, "commission_rate": 9.0 },
    { "count": 12, "total_amount": 16800, "installment_amount": 1400, "commission_rate": 12.0 }
  ]
}

Yanıt Alanları

Alan	Tip	Açıklama
bank_name	string	Kartı çıkaran banka
card_brand	string	Kart markası (visa, mastercard)
card_type	string	Kart tipi (credit, debit)
installments	array	Taksit seçenekleri listesi

Taksit Nesnesi

Alan	Tip	Açıklama
count	integer	Taksit sayısı (1 = tek çekim)
total_amount	integer	Toplam ödenecek tutar (kuruş)
installment_amount	integer	Aylık taksit tutarı (kuruş)
commission_rate	number	Komisyon oranı (%)

BIN Sorgulama

Kart BIN numarasından banka ve kart bilgilerini öğrenin:

POST /api/v1/payment/bin

{
  "session_id": "ses_xxx",
  "bin_number": "538888"
}

{
  "success": true,
  "bank_name": "Garanti BBVA",
  "card_brand": "mastercard",
  "card_type": "credit",
  "card_category": "individual"
}

bilgi

Debit kartlarda taksit seçeneği sunulmaz. Taksit sorgulamadan önce BIN sorgulama yaparak kart tipini kontrol edebilirsiniz.