> For the complete documentation index, see [llms.txt](https://docs.paratika.com.tr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.paratika.com.tr/entegrasyon/api-istekleri/sorgulama-servisleri/bin-bilgisi-sorgulama.md).

# BIN Bilgisi Sorgulama

**QUERYBIN** servisi, kredi veya banka kartına ait **BIN (Bank Identification Number)** bilgilerini sorgulamak için kullanılır. Bu servis sayesinde kartın hangi bankaya ait olduğu, kart tipi, kart ağı, sanal kart durumu ve özel kart segment bilgileri öğrenilebilir.

QUERYBIN servisi;

* Kart bilgisi girilmeden önce BIN bazlı yönlendirme
* Taksit, kampanya ve ödeme yöntemi uygunluk kontrolü
* Kayıtlı kart (token) üzerinden kart bilgisi çözümleme

amaçlarıyla kullanılır.

***

* **BIN** veya **CARDTOKEN** parametrelerinden en az biri zorunludur.
* **CARDTOKEN** gönderilmesi durumunda, sistem ilgili karttan BIN bilgisini çözer.
* Kart numarasının tamamı hiçbir zaman sistem dışına çıkarılmaz.
* 6 haneli veya 8 haneli BIN desteklenmektedir.

***

**QUERYBIN** servisi, ödeme akışının erken aşamasında kartın özelliklerini tespit ederek doğru yönlendirme ve kullanıcı deneyimi sağlamak için kritik öneme sahiptir. Taksit, kampanya ve özel kart senaryolarında temel bir yapı taşıdır.

> 📌 BIN bilgileri bankalar tarafından güncellenebilir veya değiştirilebilir. Bu nedenle, söz konusu bilgilerin doğruluğu ve güncelliği Paratika’nın sorumluluğunda değildir. Destek için **<destek@paratika.com.tr>** adresi ile iletişime geçebilirsiniz.

**QUERYBIN** isteği aşağıdaki istek alanlarını beklemektedir.

`POST` `https://entegrasyon.paratika.com.tr/paratika/api/v2`

| Parametre        | Açıklama                                                                                            |
| ---------------- | --------------------------------------------------------------------------------------------------- |
| MERCHANT         | Bilgilerim sekmesi altından temin ettiğiniz üye iş yeri numaranız gönderilmelidir.                  |
| MERCHANTUSER     | Oluşturduğunuz Merchant Api User kullanıcısının e-posta adresi gönderilmelidir.                     |
| MERCHANTPASSWORD | Oluşturduğunuz Merchant Api User kullanıcısının şifresi gönderilmelidir.                            |
| ACTION           | Bu istek tipi için **QUERYBIN** olarak gönderilmelidir.                                             |
| BIN              | Bu parametre gönderildiği zaman sorgulama servisi ilgili BIN için bilgileri döner.                  |
| CARDTOKEN        | Bu parametre gönderildiği zaman sorgulama servisi kayıtlı kartın BIN bilgisi için ddetayları döner. |

***

<figure><img src="/files/n3cZ9iHY8jodN7dMW7Wy" alt=""><figcaption></figcaption></figure>

***

<figure><img src="/files/XAKvD35QeQoxyHyRy2xz" alt=""><figcaption></figcaption></figure>

***