Taksit Sorgulama

Taksit sorgulama servisinin sonucunda kart ailelerine ait taksitli ve tek çekim ödenecek tutarlar dönülür ve bu tutar ödeme servisi paidPrice ve installment parametreleri ile beraber kullanılmalıdır. Servis eğer bin numarası girilerek kullanılmak isteniyorsa ödeme sayfasında kartın ilk 6 hanesi girildikten sonra çağırılması gerekmektedir. Dönen cevabın ise kullanıcıya taksit seçimi için gösterilmesinde kullanılır. Servisten dönen taksit seçenekleri, üye işyeri panelindeki pos yönetimi alanındaki bilgiler ile ilişkilidir.

URL

Taksit sorgulama için kullanılan endpoint ve http metod bilgisi aşağıda verilmiştir.

GETinstallment/v1/installments

İ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.

binNumber

number

Taksit sorgulama yapılacak olan kartın ilk 6 hanesi. Eğer gönderilmezse tüm taksitler dönülür. Gönderilirse eğer sadece bin numarasına ait kart ailesinin taksit sayıları dönülür
19.04.2022 14:00 tarihinde yapılacak olan 8 haneli bin geçişi sonrası 8 hane olarak gönderilmelidir

price

decimal

zorunlu

Fiyat

currency

Currency

Taksit sorgulama işleminin hangi kur için yapılacağı. bkz: Para Birimleri

Değerler:

TRY

USD

EUR

GBP

CNY

ARS

BRL

AED

IQD

AZN

KZT

KWD

SAR

BHD

RUB

JPY

EGP

distinctCardBrandsWithLowestCommissions

boolean

Taksit sorgulama sonucunda aynı kart ailesine ait birden fazla sonuç oluşması durumunda en düşük komisyona göre tekilleştirilmesi için kullanılır.

loyaltyExists

boolean

Ödeme adımında ödül/puan kullanımı varsa yada olacaksa bu parametre ile ödül/puan destekleyen bankalara ait taksitlerin dönülmesi için kullanılır.

paymentPhase

PaymentPhase

Eğer ödeme işlemi ön provizyon ile gerçekleştirilecekse bu değer PRE_AUTH olarak iletilmelidir. bkz: Ödeme Fazları

Değerler:

AUTH

PRE_AUTH

POST_AUTH

Dönüş Parametreleri

binNumber

string

Taksit sorgulama yapılan kartın ilk 6 hanesi.
19.04.2022 14:00 tarihinde yapılacak olan 8 haneli bin geçişi sonrası, 8 hane olarak dönecektir

price

decimal

Fiyat

cardType

CardType

bknz. Kart Tipleri

Değerler:

CREDIT_CARD

DEBIT_CARD

PREPAID_CARD

cardAssociation

CardAssociation

Kart Kuruluşu

Değerler:

VISA

MASTER_CARD

AMEX

TROY

JCB

UNION_PAY

MAESTRO

DISCOVER

DINERS_CLUB

cardBrand

string

Kart ailesi

bankName

string

Kartın bağlı olduğu banka ismi

bankCode

number

Banka kodu

force3ds

boolean

3ds ödeme zorunluluğu olup olmadığı bilgisi. Kullanılan kart debit ise ve üye işyeri panelinden ilgili pos için 3dsecure zorunluluğu girilmiş ise true döner. Eğer true dönmüş ise ödeme 3dsecure yapılmalıdır.

cvcRequired

boolean

Ödeme yapılırken cvc gönderilmesi zorunlu mu? Üye işyeri posu eğer cvcsiz işleme açık değilse true döner.

commercial

boolean

Ticari kart olup olmadığı bilgisi. Gıda gibi, bireysel kartlara taksit kullanımı yasak olan bir ürün sepete eklenmiş ise, commercial parametresini kontrol etmelisiniz. false döndüğünde taksit yapmamalısınız. Eğer kullanılan kart ticari bir kart ise bu parametre true dönecektir. Ticari kartlara taksit yapmak serbest olduğu için kullanıcıya taksit sunulabilir.

installmentPrices

InstallmentPrice[]

Her taksit seçeneği için fiyat bilgisini barındıran obje listesi

Örnek Kodlar

Açık kaynak kodlu Craftgate API client'larındaki örnek kodları inceleyebilirsiniz.

Java.NETPHPNode.jsGo

Loading..