Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.payven.com.tr/llms.txt

Use this file to discover all available pages before exploring further.

Taksitli ödeme, müşterinin tutarı eşit aylık taksitler halinde ödediği akıştır. Hangi taksitlerin uygulanabileceği:
  1. Banka kart programına bağlıdır (Bonus, Maximum, Axess, World, vb.)
  2. Kuruluşunuzun banka anlaşmasına bağlıdır
  3. Ödeme tutarına bağlıdır (her bankanın taksit başına minimum tutarı vardır)

​
Talep etme

Ödeme isteğine installment alanı ekleyerek taksit sayısını belirtirsiniz: 
{
  "amount": 60000,
  "installment": 6
}
Banka taksiti destekliyorsa onaylar; desteklemiyorsa VALIDATION_INVALID_INSTALLMENT döner.

​
Müşteriye seçenekleri gösterme

Müşteri kart numarasını yazdığında, BIN’e göre uygun taksit seçeneklerini göstermek istiyorsunuz. Iki yaklaşım var:
Hosted Checkout sayfası taksit seçeneklerini otomatik olarak doldurur. Sadece allowedInstallments ile sınırlama koyabilirsiniz.
{
  "amount": 60000,
  "allowedInstallments": [1, 3, 6, 9]
}

​
Yanıtta taksit bilgileri

{
  "data": {
    "id": "...",
    "amount": 60000,
    "installment": 6,
    "card": {
      "scheme": "Visa",
      "program": "Bonus",
      "bankName": "Garanti BBVA"
    },
    "connector": {
      "code": "GarantiVPOS",
      "responseCode": "00"
    }
  }
}

​
Taksit kuralları

Borç kartında taksit yok. card.type: "Debit" olan kartlarda installment > 1 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. Genel pratik: 12 ay.

​
Hata yanıtları

codeAnlam
VALIDATION_INVALID_INSTALLMENTTaksit sayısı bu kart için desteklenmiyor
INSTALLMENT_NOT_ALLOWED_ON_DEBITBorç kartında taksit yapılamaz
INSTALLMENT_AMOUNT_TOO_LOWTutar bu taksit sayısı için minimumu karşılamıyor