Taksit ve BIN Sorgulama
iyzico, BIN ve taksit sorgulama işlemleri için uygun bir yol sunar.
API, taksit sayısı, oranları ve tutarlarının yanı sıra; kartın bankası, kart ailesi ve kart şeması gibi özelliklerini sağlar. Belirtilen BIN ve tutar bilgisine göre uygun taksit seçeneklerini listeler. Ayrıca yalnızca BIN veya yalnızca tutar bilgisiyle de taksit oranları sorgulanabilir.
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 aXBzaWduYXR1cmU...
Content-Type değeri.
application/json
İstek ve dönüş mesajlarında kullanılacak dil bilgisi.
tr
Possible values: Taksit hesaplaması yapılacak tutar.
100
8 Haneli kart BIN’i. Gönderilirse kart/banka bazında uygunluk döner. Gönderilemezse tutara göre taksit oranları alınabilir.
54308100
İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.
123456789
Başarılı yanıt
Başarısız yanıt
POST https://sandbox-api.iyzipay.com/payment/iyzipos/installment
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtcU43VzljOXI3aWhZZUs5Z2ZqbFhRWFlPUUZteEQyNkEmcmFuZG9tS2V5OjE3NTY0NjkyMjgyMzQxMjM0NTY3ODkmc2lnbmF0dXJlOmRmMzEwNjI2MTI0OGNhZTcxMDJlZDQxMjhjODA4MmIwOTlhMzU4OWNmZDc3MTNkODNlODk5YWEzMDg0NDBkZDg=
Content-Type: application/json
{
"locale": "tr",
"price": 100.0,
"binNumber": "54308100",
"conversationId": "123456789"
}
{
"status": "success",
"locale": "tr",
"systemTime": 1755547819061,
"conversationId": "123456789",
"installmentDetails": [
{
"binNumber": "54308100",
"price": 100,
"cardType": "CREDIT_CARD",
"cardAssociation": "MASTER_CARD",
"cardFamilyName": "Paraf",
"force3ds": 0,
"bankCode": 12,
"bankName": "Halkbank",
"forceCvc": 0,
"commercial": 0,
"dccEnabled": 0,
"agricultureEnabled": 0,
"installmentPrices": [
{
"installmentPrice": 100,
"totalPrice": 100,
"installmentNumber": 1
},
{
"installmentPrice": 51.61,
"totalPrice": 103.22,
"installmentNumber": 2
},
{
"installmentPrice": 35.08,
"totalPrice": 105.25,
"installmentNumber": 3
},
{
"installmentPrice": 18.7,
"totalPrice": 112.22,
"installmentNumber": 6
},
{
"installmentPrice": 13.35,
"totalPrice": 120.19,
"installmentNumber": 9
},
{
"installmentPrice": 10.77,
"totalPrice": 129.2,
"installmentNumber": 12
}
]
}
]
}
Örnek Kodlar
BIN sorgulamada kartın bankası, kart ailesi, kart şeması gibi kart özelliklerini sağlar. İstenen bilgileri elde etmek için, talebinize gerekli parametreleri eklemeniz yeterlidir. API, kapsamlı ayrıntılarla yanıt verecektir.
Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.
IYZWSv2 aXBzaWduYXR1cmU...
Content-Type değeri.
application/json
İstek ve dönüş mesajlarında kullanılacak dil bilgisi.
tr
Possible values: Sorgulanacak BIN (8 hane).
542119
İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.
1a2b3c4d5e6f
Başarılı yanıt
Başarısız yanıt
POST https://sandbox-api.iyzipay.com/payment/bin/check
Authorization: IYZWSv2 YXBpS2V5OnNhbmRib3gtNE9hdVQwRXNSUjk3bmlqZVBRTWxGMTNrVHA2Rk9lNjkmcmFuZG9tS2V5OjEyMzQ1Njc4OSZzaWduYXR1cmU6MTZmMmEwZTJiZjU4ZmZkZTcwZWMxZWIzZGU5Y2IwNTRkMjk4Zjc1NThlNmRiMmQwYTQ2NjA4NzJmYzY0NGFjNg==
Content-Type: application/json
{
"locale": "tr",
"binNumber": "542119",
"conversationId": "1a2b3c4d5e6f"
}
{
"binNumber": "542119",
"cardType": "CREDIT_CARD",
"cardAssociation": "MASTER_CARD",
"cardFamily": "World",
"bankName": "Vakıfbank",
"bankCode": 15,
"commercial": 0,
"status": "success",
"locale": "tr",
"systemTime": 1755547712091,
"conversationId": "1a2b3c4d5e6f"
}
Örnek Kodlar
Öneriler
Servis tarafından verilen cevaba göre aşağıdaki kurallar dikkate alınabilir;
card_type
parametresiDEBIT_CARD
olarak döndüğünde 3DS ödeme yöntemi kullanılması önerilir.Önyüzde
card_family
alanındaki değerlere göre taksit seçenekleri görüntülenebilir. Taksitli ödemeye uygun kart aileleri arasında Bonus, World, Maximum, Axess, Cardfinans, Paraf ve Advantage yer almaktadır.force3ds
değeri 1 olarak dönerse, işlemin 3DS ile işlenmesi gerektiği anlamına gelir. 0 ise tercihlere göre işlem yapılabilir. İşyeri hesabında 3DS zorunlu olarak ayarlanmışsa, bu değer sürekli olarak 1 döndürür.Talepte BIN numarası belirtilmemişse, mevcut tüm taksit seçenekleri görüntülenecektir. Ancak, BIN numarası verilirse, yalnızca ilgili ve o karta özel taksit seçeneklerini içerecektir.
Taksit sorgulama, iyzico üye iş yeri kontrol panelindeki "Taksit ve Komisyon Ayarları" bölümünde tanımlanan taksit oranlarını getirir. Bu bölümde yapılan değişiklikler otomatik olarak taksit hizmetine yansıtılacaktır.
Last updated