> For the complete documentation index, see [llms.txt](https://docs.morpara.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.morpara.com/api-dokumantasyonu/destekleyiciservisler/bincheck.md).

# BIN Kontrol

BIN Kontrol servisi, girilen kart numarasına ait **BIN bilgilerini** sorgulamak için kullanılır.

Bu servis ile:

* Kartın bağlı olduğu banka
* Kart tipi (kredi / banka / ön ödemeli)
* Kart markası (Visa, Mastercard vb.)
* Kartın ticari olup olmadığı

gibi temel kart özellikleri öğrenilebilir.

> ℹ️ BIN sorgulama işlemi **finansal bir işlem değildir** ve ödeme başlatmaz.

***

### Endpoint

```http
POST /v1/BinList/CheckBin
```

***

### Headers

| Anahtar        | Tür    | Açıklama                                 | Örnek                      |
| -------------- | ------ | ---------------------------------------- | -------------------------- |
| x-ClientID     | String | API istemcisi için benzersiz tanımlayıcı | sizin-istemci-id'niz       |
| x-ClientSecret | String | API istemcisi için gizli anahtar         | sizin-gizli-anahtarınız    |
| x-GrantType    | String | Kullanılan erişim tokeni türü            | istemci\_kimlik\_bilgileri |
| x-Scope        | String | API kapsamı                              | pf\_write, pf\_read        |
| x-Timestamp    | String | İstek zaman damgası                      | 2024-12-17T12:34:56Z       |

***

### Request Body

| Alan     | Zorunlu | Tür     | Açıklama                               | Örnek                   |
| -------- | ------- | ------- | -------------------------------------- | ----------------------- |
| bin      | ✅       | Integer | 4 veya 6 haneli BIN numarası           | 402940                  |
| language | ✅       | String  | İşlem dili                             | tr                      |
| sign     | ✅       | String  | İsteğin doğrulanması için dijital imza | AAVWY3RZKJVVCEAD8LDQB4K |

***

### Response Body

BIN kontrol servisi, sorgulanan karta ait banka ve kart bilgilerini döner.

#### Örnek Request

```http
POST /v1/BinList/CheckBin
Content-Type: application/json
x-ClientID: sizin-istemci-id'niz
x-ClientSecret: sizin-gizli-anahtarınız
x-GrantType: istemci_kimlik_bilgileri
x-Scope: pf_write, pf_read
x-Timestamp: 2024-12-17T12:34:56Z
```

```json
{
  "responseCode": "B0000",
  "responseDescription": "Approved",
  "responseDate": "2025-02-05T17:26:54.3277205+03:00",
  "conversationId": "BSR29715509646227267",
  "bin": "402940",
  "cardType": "B",
  "cardBrand": "VISA / World",
  "bankName": "T.VAKIFLAR BANKASI T.A.O.",
  "bankCode": "0015",
  "commercial": "0"
}

```

#### Örnek Response

```json
{
  "responseCode": "B0000",
  "responseDescription": "Approved",
  "responseDate": "2025-02-05T17:26:54.3277205+03:00",
  "conversationId": "BSR29715509646227267",
  "bin": "402940",
  "cardType": "B",
  "cardBrand": "VISA / World",
  "bankName": "T.VAKIFLAR BANKASI T.A.O.",
  "bankCode": "0015",
  "commercial": "0"
}

```