Taksit Sorgulama | Odero Documentation

Güncel sözleşme: GET /installment/v1/installments, JSON gövdeli POST /installment/v1/installments/retrieve ve cüzdan akışı için GET /installment/v1/installments/retrieveWalletInstallments kullanılabilir. Header'da merchantId gönderilir. binNumber kartın ilk 6–8 hanesidir; price zorunlu ve sıfır veya pozitiftir. İstek ayrıca excludeGatewayPos, subMerchantIds, productItems, buyerId, branch, checkoutToken, garantiPay ve subscription alanlarını destekler. Yanıta farmerCard, posAlias ve installment kırılımına buyerPfCommissionRate eklenmiştir.

İstek Parametreleri

Taksit sorgulama işlemi gerçekleştirmek için yapılacak isteklerde gönderilmesi beklenen parametreler aşağıdaki tablo ve alt başlıklar altında listelenmiştir.

Parametre Adı	Tipi	Zorunlu	Açıklama
`binNumber`	`string`	Hayır	Taksit sorgulanacak kartın ilk 6–8 hanesi
`price`	`decimal`	Evet	Fiyat
`excludeGatewayPos`	`boolean`	Hayır	Gateway POS sonuçlarını hariç tutar; varsayılan `false`.
`subMerchantIds`	`long[]`	Hayır	Alt üye işyeri kimlikleri.
`productItems`	`ProductItem[]`	Hayır	Taksit kurallarında kullanılacak ürün bilgileri.
`buyerId`	`long`	Hayır	Alıcı kimliği.
`branch`	`string`	Hayır	Şube bilgisi.
`checkoutToken`	`string`	Hayır	Checkout akışı tokenı.
`garantiPay`	`boolean`	Hayır	GarantiPay akışı; varsayılan `false`.
`subscription`	`string`	Hayır	Abonelik bilgisi.
`currency`	`string`	Hayır	Taksit sorgulama işleminin hangi kur için yapılacağı. `TRY`, `EUR` ya da `USD`

Dönüş Parametreleri

Parametre Adı	Tipi	Açıklama
`binNumber`	`string`	Taksit sorgulanan kartın ilk 6–8 hanesi
`price`	`decimal`	Fiyat
`cardType`	`CardType`	Kart türü. `CREDIT_CARD`, `DEBIT_CARD` ya da `PREPAID_CARD` bknz. Kart Tipleri
`cardAssociation`	`CardAssociation`	Kart kuruluşu. `VISA`, `MASTER_CARD`, `AMEX` ya da `TROY` bknz. Kart Kuruluşları
`cardBrand`	`string`	Kart markası
`bankName`	`string`	Banka ismi
`bankCode`	`number`	Banka kodu
`force3ds`	`boolean`	3ds ödeme zorunluluğu olup olmadığı bilgisi
`commercial`	`boolean`	Ticari olup olmadığı bilgisi
`farmerCard`	`boolean`	Çiftçi kartı olup olmadığı.
`posAlias`	`string`	POS takma adı.
`installmentPrices`	`InstallmentPrice[]`	Her taksit seçeneği için fiyat bilgisini barındıran Taksit Fiyat Bilgileri obje listesi

Taksit Fiyat Bilgileri

Taksit ve fiyat bilgilerini içeren objenin alanları aşağıdaki gibidir.

Parametre Adı	Tipi	Açıklama
`installmentNumber`	`number`	Taksit sayısı
`installmentPrice`	`number`	Taksit sayısına karşılık gelen taksit ücreti
`totalPrice`	`number`	Toplam fiyat
`additionalInstallment`	`number`	Ek taksit sayısı.
`description`	`string`	Taksit açıklaması.
`pfCommissionRate`	`decimal`	Ödeme kuruluşu komisyon oranı.
`buyerServicePrice`	`decimal`	Alıcı hizmet bedeli.
`buyerPfCommissionRate`	`decimal`	Alıcı ödeme kuruluşu komisyon oranı.

Örnek Kodlar

Açık kaynak kodlu ÖderoPay API client'larındaki örnek kodları inceleyebilirsiniz