Skip to main content
Bin Sorgulama servisi, müşterinin kart numarasının ilk 6 veya 8 hanesi (BIN) ya da kart token bilgisi gönderilerek kartın banka, kart tipi ve benzeri temel bilgilerinin sorgulanmasını sağlar. İstek Tipi: application/json

​
Tablo 5.39. Bin Sorgulama Servisi Girdi Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
cardTokenstringOluşturulan token bilgisiEvet
binNumberstringKarta ait BIN değeriEvet
languageCodestringCevabın alınacağı dil bilgisi (default: TR)Hayır

​
Tablo 5.40. Bin Sorgulama Servisi Örnek Request

{
  "cardToken": "",
  "binNumber": "979210",
  "languageCode": "TR"
}

​
Tablo 5.41. Bin Sorgulama Servisi Çıktı Parametreleri

Parametre AdıVeri TipiAçıklamaZorunluluk
conversationIdstringÜye iş yeri benzersiz değeriEvet
isSucceededboolean (true/false)İşlem durumuEvet
errorCodestringHata koduEvet
errorMessagestringHata mesajıEvet
binNumberstringİşlem yapılan karta ait BIN değeriEvet
cardBrandstringKart markası (Undefined / JCB / UnionPay / Maestro / Amex / Visa / Troy / Master / Discover / Diners)Evet
cardNetworkstringKart ağı (Unknown / CardFinans / MilesSmiles / World / Paraf / Maximum / Axess / AsyaCard / Advantage / Bonus / BankKartCombo)Evet
cardTypestringKart tipi (Unknown / Credit / Debit)Evet
cardSubTypestringKart seviyesi (Unknown / Classic / Business)Evet
bankCodeintegerKartın bankasına ait kodEvet
bankNamestringKart bankasının adıEvet
isVirtualboolean (true/false)Sanal kart bilgisiEvet
extraParametersarray[object]Ek parametre alanıHayır
binRangeMaxstringBIN aralığı üst limitiHayır
binRangeMinstringBIN aralığı alt limitiHayır
isDomesticboolYurt içi / yurt dışı kart bilgisiHayır

​
Tablo 5.42. Bin Sorgulama Servisi Örnek Response

{
  "binNumber": "979210",
  "cardBrand": "Undefined",
  "cardNetwork": "Unknown",
  "cardType": "Unknown",
  "cardSubType": "Unknown",
  "bankCode": 0,
  "bankName": "",
  "isVirtual": false,
  "extraParameters": null,
  "binRangeMax": "979210",
  "binRangeMin": "979210",
  "isDomestic": false,
  "isSucceeded": false,
  "errorCode": null,
  "errorMessage": null,
  "responseHeader": {
    "conversationId": "1676398178",
    "responseDateTime": "20251205171653296",
    "responseCode": "PFC032",
    "responseDescription": "Geçersiz işlem bilgisi. Lütfen daha sonra tekrar deneyiniz.",
    "transactionId": "00000000-0000-0000-0000-000000000000",
    "requestId": null,
    "processingTime": 101,
    "apiVersion": "1.0.1"
  }
}