Taksit ve BIN Sorgulama

iyzico, BIN ve taksit sorgulama işlemleri için uygun bir yol sunar.

Taksit Sorgulama

post

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.

Header parameters
AuthorizationstringRequired

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Example: IYZWSv2 aXBzaWduYXR1cmU...
Content-TypestringRequired

Content-Type değeri.

Example: application/json
Body
localestring · enumOptional

İstek ve dönüş mesajlarında kullanılacak dil bilgisi.

Example: trPossible values:
pricenumber · decimalRequired

Taksit hesaplaması yapılacak tutar.

Example: 100
binNumberstringOptional

8 Haneli kart BIN’i. Gönderilirse kart/banka bazında uygunluk döner. Gönderilemezse tutara göre taksit oranları alınabilir.

Example: 54308100
conversationIdstringOptional

İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.

Example: 123456789
Responses
200

Başarılı yanıt

application/json
post
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 Sorgulama

post

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.

Header parameters
AuthorizationstringRequired

Authorization header, IYZWSv2 ile başlayan ve base64 formatında üretilmiş imzalı hash değeridir.

Example: IYZWSv2 aXBzaWduYXR1cmU...
Content-TypestringRequired

Content-Type değeri.

Example: application/json
Body
localestring · enumOptional

İstek ve dönüş mesajlarında kullanılacak dil bilgisi.

Example: trPossible values:
binNumberstringRequired

Sorgulanacak BIN (8 hane).

Example: 542119
conversationIdstringOptional

İstek/yanıt eşleştirme ID’si. İstekte gönderilen değer, response'da aynen geri döner.

Example: 1a2b3c4d5e6f
Responses
200

Başarılı yanıt

application/json
post
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 parametresi DEBIT_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