Skip to main content
Taksitli ödeme, müşterinin tutarı eşit aylık taksitler halinde ödediği akıştır. Hangi taksitlerin uygulanabileceği üç parametreye bağlıdır:
  1. Banka kart programı (Bonus, Maximum, Axess, World, Paraf, Cardfinans, vb.)
  2. Organizasyonunuzun banka anlaşması (her banka kendi taksit kampanyalarını tanımlar)
  3. Ödeme tutarı (her bankanın taksit başına minimum tutarı vardır)

​
İstekte taksit alanı

CreatePaymentRequest ve Init3DRequest body’lerinde installment alanı taksit sayısını taşır: 
{
  "amount":         { "amount": 60000, "currency": "TRY" },
  "installment":    6,
  "operation_type": "sale",
  "card":           { ... }
}
DeğerAnlam
1Peşin (varsayılan)
2–12Aylık taksit sayısı
Banka taksiti destekliyorsa onaylar; desteklemiyorsa 422 invalid_installment hatası döner.

​
Müşteriye uygun seçenekleri sunma

Müşteri kart numarasını yazdığında, BIN’e göre uygun taksit seçeneklerini göstermek istiyorsunuz. İki yaklaşım:
Hosted Checkout sayfası taksit seçeneklerini otomatik doldurur — kart programı, BIN ve banka anlaşması bazlı tüm sınırları Payven yönetir.Sadece üst sınır koymak isterseniz allowed_installments ile filtreleyin:
{
  "amount":               { "amount": 60000, "currency": "TRY" },
  "allowed_installments": [1, 3, 6, 9]
}

​
Yanıttaki taksit bilgisi

PaymentStatus (sorgulama) yanıtında işlem yapılırken kullanılan taksit sayısı bulunur: 
{
  "transaction_id": "...",
  "amount":         60000,
  "currency":       "TRY",
  "is_3d_secure":   true,
  "extra_properties": {
    "auth_code":               "123456",
    "host_reference":          "PAYVEN-REF-789",
    "provider_transaction_id": "9f3d2b8e-..."
  }
}
Taksit sayısı request’te belirttiğiniz değerdir; banka onayında extra_properties.installment da olabilir (konnektöre göre değişir).

​
Taksit kuralları

Borç/prepaid kartında taksit yok. Bu kartlarda installment > 1 422 invalid_installment ile reddedilir.
Yabancı kartta taksit yok. Yurt dışı bankalarının kartları taksite uygun değildir.
Minimum tutar. Her bankanın taksit başına minimum tutar şartı vardır (genelde 100 ₺).
Maximum taksit. Bankaya göre değişir. Yaygın üst sınır 12 ay; bazı kampanyalarda 18-24 ay.
Komisyon kart programına bağlı. Her banka kendi taksit kampanyasını tanımlar — organizasyon anlaşmanıza yansır.

​
Hata response’ları

HTTPcodeAnlam
422invalid_installmentTaksit sayısı bu kart için desteklenmiyor (debit/prepaid/yurtdışı kart, tutar minimumu altında, banka destek vermiyor)
422bank_declinedBanka taksit talebini reddetti (anlaşma dışı)
Hata yanıtı RFC 9457 problem+json formatındadır.

​
Yol haritası

  • Public installment lookup endpoint — BIN + tutar kombinasyonu için izin verilen taksit listesini canlı sorgulama
  • Kampanya editor UI — banka kampanyalarını konsoldan kural motoruna eklemek
Güncellemeler için: Changelog.