Taksit sorgulama(installment), ilgili kart bir kredi kartı ise ve bir taksit programına dahil ise, kaç taksit yapılabileceği ve taksit komisyon oranı konusunda bilgi vermektedir.
Servise gönderilmesi gereken parametreler şu şekildedir:
Parametre ismi | Tip | Zorunluluk | Açıklama |
---|---|---|---|
binNumber | string | hayır | Kartın ilk 6 hanesidir. |
locale | string | hayır | iyzico istek sonucunda dönen metinlerin dilini ayarlamak için kullanılır. Varsayılan değeri tr’dir. |
conversationId | string | hayır | İstek esnasında gönderip, sonuçta alabileceğiniz bir değer, request/response eşleşmesi yapmak için kullanılabilir. |
price | string | evet | Taksitlendirilmek istenen tutar bilgisi. |
Servisten dönen parametreler şu şekildedir:
Parametre ismi | Tip | Açıklama |
---|---|---|
status | string | Yapılan isteğin sonucunu bildirir. İşlem başarılı ise success, hatalı ise failure döner. |
locale | string | İstekte belirtilen locale değeri geri dönülür, varsayılan değeri trdir. |
systemTime | integer | Dönen sonucun o anki unix timestamp değeridir. |
conversationId | string | İstek esnasında gönderilmişse, sonuçta aynen geri iletilir. |
binNumber (installmentDetails) | string | Kartın ilk 6 hanesidir. |
price (installmentDetails) | string | Toplam tutar. |
cardType (installmentDetails) | string | Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu tipi. Geçerli değerler: CREDIT_CARD, DEBIT_CARD, PREPAID_CARD |
cardAssociation (installmentDetails) | string | Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu kuruluş. Geçerli değerler: TROY, VISA, MASTER_CARD, AMERICAN_EXPRESS |
cardFamilyName (installmentDetails) | string | Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu aile. Geçerli değerler: Bonus, Axess, World, Maximum, Paraf, CardFinans, Advantage |
force3ds (installmentDetails) | string | İşlemin 3ds yapılmasına gerek olup olmadığını gösterir. 1 veya 0 değerlerini alır. 1 ise işlem 3ds ile yapılmalıdır. |
bankName (installmentDetails) | string | Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu banka adı. |
bankCode(installmentDetails) | integer | Eğer ödeme yapılan kart yerel bir kart ise, kartın ait olduğu banka kodu. |
installmentPrice (installmentPrices)(installmentDetails) | string | Taksit başına düşen tutar. |
totalPrice (installmentPrices)(installmentDetails) | string | Toplam taksitli tutar. |
installmentNumber (installmentPrices)(installmentDetails) | string | Taksit sayısı. |
errorCode | string | İşlem hatalıysa, bu hataya dair belirtilen koddur. |
errorMessage | string | İşlem hatalıysa, bu hataya dair belirtilen mesajdır. Locale parametresine göre dil desteği sunar. |
errorGroup | string | İşlem hatalıysa, bu hataya dair belirtilen gruptur. |
$request = new \Iyzipay\Request\RetrieveInstallmentInfoRequest();
$request->setLocale(\Iyzipay\Model\Locale::TR);
$request->setConversationId("123456789");
$request->setBinNumber("554960");
$request->setPrice("100");
$installmentInfo = \Iyzipay\Model\InstallmentInfo::retrieve($request, Config::options());
RetrieveInstallmentInfoRequest request = new RetrieveInstallmentInfoRequest();
request.Locale = Locale.TR.ToString();
request.ConversationId = "123456789";
request.BinNumber = "554960";
request.Price = "100";
InstallmentInfo installmentInfo = InstallmentInfo.Retrieve(request, options);
RetrieveInstallmentInfoRequest request = new RetrieveInstallmentInfoRequest();
request.setLocale(Locale.TR.getValue());
request.setConversationId("123456789");
request.setBinNumber("554960");
request.setPrice(new BigDecimal("100"));
InstallmentInfo installmentInfo = InstallmentInfo.retrieve(request, options);
iyzipay.installmentInfo.retrieve({
locale: Iyzipay.LOCALE.TR,
conversationId: '123456789',
binNumber: '554960',
price: '100'
}, function (err, result) {
console.log(err, result);
done();
});
request = {
locale: 'tr',
conversationId: '123456789',
binNumber: '454671',
price: '1',
}
installment_info = Iyzipay::Model::InstallmentInfo.new.retrieve(request, @options)
request = dict([('locale', 'tr')])
request['conversationId'] = '123456789'
request['binNumber'] = '454671'
request['price'] = '1'
installment_info = iyzipay.InstallmentInfo()
installment_info_response = installment_info.retrieve(request, options)
//Request
"locale": "tr",
"conversationId": "123456789",
"binNumber": "454360",
"price": "100.0"
//Response
{
"status": "success",
"locale": "tr",
"systemTime": 1470727458044,
"conversationId": "123456789",
"installmentDetails": [
{
"binNumber": "454360",
"price": 100,
"cardType": "CREDIT_CARD",
"cardAssociation": "VISA",
"cardFamilyName": "Maximum",
"force3ds": 0,
"bankCode": 64,
"bankName": "İş Bankası",
"forceCvc": 0,
"installmentPrices": [
{
"installmentPrice": 100,
"totalPrice": 100,
"installmentNumber": 1
},
{
"installmentPrice": 50.68,
"totalPrice": 101.36,
"installmentNumber": 2
},
{
"installmentPrice": 33.95,
"totalPrice": 101.86,
"installmentNumber": 3
},
{
"installmentPrice": 17.43,
"totalPrice": 104.58,
"installmentNumber": 6
},
{
"installmentPrice": 12.19,
"totalPrice": 109.67,
"installmentNumber": 9
}
]
}
]
}
Örnek Kodlar