> 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/kayitli-kart-bilgisi-sorgulama.md).

# Kayıtlı Kart Bilgisi Sorgulama

**QUERYCARD** servisi, bir kart sahibine (müşteri) ait sistemde daha önce kaydedilmiş kartların sorgulanması veya belirli bir **CARDTOKEN** değerine ait kart detaylarının alınması veya belirli bir müşteriye (**CUSTOMER**) ait kayıtlı kartların sorgulanması amacıyla kullanılır.

Bu servis sayesinde;

* Bir müşteriye (**CUSTOMER**) ait tüm kayıtlı kartlar listelenebilir
* Belirli bir kart token’ına (**CARDTOKEN** ) ait detaylı kart bilgileri görüntülenebilir
* Customer veya CardToken parametreleri gönderilmez ise üye iş yerine ait tüm müşterilerin kaydedilmiş kartları listenebilir.

***

* **CARDTOKEN** gönderilirse, sadece ilgili karta ait bilgiler döndürülür.
* **CARDTOKEN gönderilmezse**, CUSTOMER parametresi ile müşteriye ait tüm kayıtlı kartlar listelenir.
* Kart numarası (PAN) **tam haliyle hiçbir zaman dönülmez**, maskeleme uygulanır.
* CUSTOMER alanı üye iş yeri tarafında **tekil (unique)** olmalıdır.

**QUERYCARD** servisi, PCI-DSS uyumlu şekilde kart verilerinin tokenize edilerek güvenli biçimde yönetilmesini sağlar. Kayıtlı kart deneyimi sunmak isteyen üye iş yerleri için temel ve kritik bir servistir.

**QUERYCARD** 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 **QUERYCARD** olarak gönderilmelidir.                                                   |
| CUSTOMER         | Bu parametre gönderildiği zaman sorgulama servisi ilgili kart sahibi müşteriye ait kayıtlı kartları döner. |
| CARDTOKEN        | Bu parametre gönderildiği zaman sorgulama servisi sadece ilgili tekil kartın detaylarını döner.            |

***

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

***

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

***

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