Kartsız Taksit Görünümü

Bu sayfa kart girilmeden önce taksit ve toplam tutar tablosu göstermeyi anlatır. Kesin tutar yine kart girildikten sonra yapılan sorgudan gelir.

Kart sahibi kartını henüz girmeden, borç özeti ekranında taksit seçeneklerini göstermek isteyebilirsiniz. Bu uç, terminalinizde o anda geçerli bütün taksit seçeneklerini kart profili gruplarıyla ve her taksit sayısı için en pahalı seçeneği döner. Kart profili, kart tipi, kartı çıkaran banka ve taksit markasının birleşimidir.

Bu uç kartı görmez. Bu yüzden hangi grubun kart sahibinin kartına uygulanacağını söyleyemez. Yalnız terminalinizde mümkün olan bütün profilleri listeler. Kart sahibi kartının ilk 8 hanesini girdiğinde kesin sonuç için Taksit ve Toplam Tutar Sorgusu ucuna geçin. Uç POST isteğiyle çağrılır.

POST /v1/installment-options/overview
Authorization: Bearer ldg_test_…
Content-Type: application/json

İstek

{
  "terminalId": "trm_3Kd9x",
  "baseAmount": 15000
}

Alan	Zorunlu	Anlamı
terminalId	Evet	Sorgulanacak terminal. Size ait ve aktif olmalıdır. Aksi halde terminal_not_allowed döner.
baseAmount	Hayır	Anapara, kuruş cinsinden tamsayı. En az 1. Gönderirseniz her seçenek tutar kırılımı taşır ve en pahalı seçenek tutara göre belirlenir. Göndermezseniz yanıt yalnız oran listesidir ve en pahalı seçenek orana göre belirlenir.

Yanıt

200 OK:

{
  "commissionBasis": "net",
  "maximums": [
    { "option": { "installmentCount": 1, "rateBps": 375, "fixedFee": null,
        "baseAmount": 15000, "commissionAmount": 563, "customerShareAmount": 563, "totalAmount": 15563 },
      "source": { "cardType": "credit", "onUs": false, "cardBrand": null } },
    { "option": { "installmentCount": 3, "rateBps": 525, "fixedFee": null,
        "baseAmount": 15000, "commissionAmount": 788, "customerShareAmount": 788, "totalAmount": 15788 },
      "source": { "cardType": "credit", "onUs": true, "cardBrand": "paraf" } },
    { "option": { "installmentCount": 6, "rateBps": 650, "fixedFee": null,
        "baseAmount": 15000, "commissionAmount": 975, "customerShareAmount": 975, "totalAmount": 15975 },
      "source": { "cardType": "credit", "onUs": true, "cardBrand": "paraf" } }
  ],
  "optionGroups": [
    { "cardType": "credit", "onUs": false, "cardBrand": null, "onUsRequired": null,
      "options": [ { "installmentCount": 1, "rateBps": 375, "fixedFee": null,
          "baseAmount": 15000, "commissionAmount": 563, "customerShareAmount": 563, "totalAmount": 15563 } ] },
    { "cardType": "credit", "onUs": true, "cardBrand": null, "onUsRequired": null,
      "options": [ { "installmentCount": 1, "rateBps": 300, "fixedFee": null,
          "baseAmount": 15000, "commissionAmount": 450, "customerShareAmount": 450, "totalAmount": 15450 } ] },
    { "cardType": "credit", "onUs": true, "cardBrand": "paraf", "onUsRequired": null,
      "options": [
        { "installmentCount": 1, "rateBps": 300, "fixedFee": null,
          "baseAmount": 15000, "commissionAmount": 450, "customerShareAmount": 450, "totalAmount": 15450 },
        { "installmentCount": 3, "rateBps": 525, "fixedFee": null,
          "baseAmount": 15000, "commissionAmount": 788, "customerShareAmount": 788, "totalAmount": 15788 },
        { "installmentCount": 6, "rateBps": 650, "fixedFee": null,
          "baseAmount": 15000, "commissionAmount": 975, "customerShareAmount": 975, "totalAmount": 15975 }
      ] }
  ]
}

Bu örnekte terminal kredi kartı kabul ediyor. Terminalin bağlı olduğu bankanın kendi kartlarında oran daha düşüktür. onUs: true için oran 300, diğer bankaların kartlarında 375 olur. paraf markalı kartlarda taksit yalnız bankanın kendi kartlarında açılıyor. Bu yüzden markalı grup onUs: true ile geliyor ve tek çekim satırının yanında 3 ve 6 taksit satırlarını taşıyor.

Alan	Anlamı
commissionBasis	Komisyon tabanı. Belediye terminallerinde her zaman net.
maximums	Her taksit sayısı için tek en pahalı seçenek ve onu üreten kart profili. Taksit sayısına göre artan sıralı.
maximums[].option	Taksit satırı. Alanları Taksit ve Toplam Tutar Sorgusu ucunun options[] satırıyla aynıdır.
maximums[].source	Bu satırı üreten kart profili: cardType, onUs, cardBrand.
optionGroups	Terminalinizde uygulanabilir her kart profili için bir grup. Boş grup dönmez.
optionGroups[].cardType	Kart tipi: credit kredi kartı, debit banka kartı, prepaid ön ödemeli kart, foreign yurt dışı kart. Belediye terminallerinde her grupta doludur.
optionGroups[].onUs	true ise kart terminalin bağlı olduğu bankanın kendi kartıdır. false ise başka bankanın kartıdır. Belediye terminallerinde her grupta doludur.
optionGroups[].cardBrand	Taksit markası. Markasız gruplarda null.
optionGroups[].onUsRequired	Belediye terminallerinde her zaman null döner. Bu alanı kullanmayın.
optionGroups[].options	Bu profildeki taksit satırları. Taksit sayısına göre artan sıralı.

Gruplar nasıl kurulur

Markasız gruplar terminalinizde izinli her kart tipi için kurulur. Markalı gruplar terminalinizin banka bağlantısında tanımlı her marka için kurulur. Tek çekim satırı yalnız terminalinizde tek çekime izin veriliyorsa bulunur. Taksit satırları yalnız o marka ve kart için taksit izni varsa eklenir. Ekranınızda grupları yanıtta dönen satırlarla gösterin. Bir markalı grubun satırları markasız grupla birebir aynıysa o grup ayrıca listelenmez.

En pahalı seçenek nasıl belirlenir

maximums listesindeki her taksit sayısı için ölçüt isteğinize göre değişir:

• baseAmount gönderdiyseniz en yüksek totalAmount kazanır.
• baseAmount göndermediyseniz en yüksek rateBps kazanır. Eşitlikte büyük fixedFee kazanır.

Kapsama garantisi

Bu ucun döndürdüğü kart profili grupları, kartlı sorgunun çözülebilen bir BIN ile döndürebileceği her seçeneği kapsar. Kartın BIN’i sistemde tanımlıysa, o kart için kartlı sorgudan alacağınız her satır burada ilgili grupta aynı değerlerle yer alır.

Not

Kartın BIN’i sistemde tanımlı değilse kartlı sorgu kartı kredi kartı sayar ve yalnız tek çekim oranını döner. Bu durum kapsama garantisinin dışındadır.

Boş liste

maximums ve optionGroups ikisi de boş dönebilir. Bu, terminalinizde hiçbir kart profiliyle tek çekim dahil ödeme sunulamadığı anlamına gelir. En yaygın nedenler terminalinizin banka bağlantısının pasif olması ya da terminalinizde hiçbir kart ailesine izin verilmemesidir. Boş yanıt geldiğinde ekranınızda taksit seçeneği sunmayın ve LydiaGate’e başvurun.

Hız limiti

Bu uç, Taksit ve Toplam Tutar Sorgusu ile aynı hız limiti kovasını kullanır. Hesap başına dakikalık tavan iki uç arasında ortaktır. Aşımda 429 alırsınız. Yanıtta Retry-After başlığı varsa belirtilen süre kadar bekleyin. Başlık yoksa artan aralıklarla tekrar deneyin.

Olası hatalar

Kod	HTTP	Sebep
validation_error	400	terminalId eksik ya da baseAmount 1’den küçük.
terminal_not_allowed	403	Terminal size ait değil ya da pasif.
rate_limited	429	Hız limiti aşıldı.

Tam liste: Hata Kodları.

İlgili

• Taksit ve Toplam Tutar Sorgusu: kart girildikten sonra kesin sorgu.
• Ödeme Oluştur: taksit sayısını ve toplam tutarı ödeme oluştururken gönderirsiniz.