> ## Documentation Index
> Fetch the complete documentation index at: https://developer.1000pay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Bin Sorgulama

> Bin Sorgulama servisi, kartın BIN veya token bilgisi üzerinden temel kart detaylarını sorgulamak için kullanılır.

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 Tipi | Açıklama | Zorunluluk |
| - | - | - | - |
| cardToken | string | Oluşturulan token bilgisi | Evet |
| binNumber | string | Karta ait BIN değeri | Evet |
| languageCode | string | Cevabın alınacağı dil bilgisi (default: TR) | Hayır |

### Tablo 5.40. Bin Sorgulama Servisi Örnek Request

<CodeGroup dropdown>
  ```json theme="dracula" theme={null}
  {
    "cardToken": "",
    "binNumber": "979210",
    "languageCode": "TR"
  }
  ```
</CodeGroup>

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

| Parametre Adı | Veri Tipi | Açıklama | Zorunluluk |
| - | - | - | - |
| conversationId | string | Üye iş yeri benzersiz değeri | Evet |
| isSucceed | bool (true/false) | İşlem durumu | Evet |
| errorCode | string | Hata kodu | Evet |
| errorMessage | string | Hata mesajı | Evet |
| binNumber | string | İşlem yapılan karta ait BIN değeri | Evet |
| cardBrand | string | Kart markası (Undefined / JCB / UnionPay / Maestro / Amex / Visa / Troy / Master / Discover / Diners) | Evet |
| cardNetwork | string | Kart ağı (Unknown / CardFinans / MilesSmiles / World / Paraf / Maximum / Axess / AsyaCard / Advantage / Bonus / BankKartCombo) | Evet |
| cardType | string | Kart tipi (Unknown / Credit / Debit) | Evet |
| cardSubType | string | Kart seviyesi (Unknown / Classic / Business) | Evet |
| bankCode | integer | Kartın bankasına ait kod | Evet |
| bankName | string | Kart bankasının adı | Evet |
| isVirtual | boolean (true/false) | Sanal kart bilgisi | Evet |
| extraParameters | array\[object] | Ek parametre alanı | Hayır |
| binRangeMax | string | BIN aralığı üst limiti | Hayır |
| binRangeMin | string | BIN aralığı alt limiti | Hayır |
| isDomestic | bool | Yurt içi / yurt dışı kart bilgisi | Hayır |

### Tablo 5.42. Bin Sorgulama Servisi Örnek Response

<CodeGroup dropdown>
  ```json theme="dracula" theme={null}
  {
    "binNumber": "979210",
    "cardBrand": "Undefined",
    "cardNetwork": "Unknown",
    "cardType": "Unknown",
    "cardSubType": "Unknown",
    "bankCode": 0,
    "bankName": "",
    "isVirtual": false,
    "extraParameters": null,
    "binRangeMax": "979210",
    "binRangeMin": "979210",
    "isDomestic": false,
    "isSucceed": 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"
    }
  }
  ```
</CodeGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.