> For the complete documentation index, see [llms.txt](https://developer.paywall.one/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.paywall.one/kart-saklama-servisi/kara-liste/3.-sorgula.md).

# 3. Sorgula

## Kayıtlı kart listesi

<mark style="color:blue;">`GET`</mark> `{{Base Adres}}/paywall/blacklist/card/inquiry`

{% hint style="info" %}
Önemli: Kart işlemleri yüksek güvenlikli işlemlerdir. Bu nedenle 'Header' alanında '**apikeyprivate**' ve '**apiclientprivate**' parametrelerini göndermeniz gerekmektedir.\
\
[<mark style="color:green;">**CardWallAPI Adresi**</mark>](/ortam.md)
{% endhint %}

**Gerekli header ve istek parametreleri :**

<details>

<summary><strong>Parametreler ve açıklamaları</strong></summary>

<table><thead><tr><th width="211">Parametre (Headers)</th><th width="93">Tip</th><th width="106">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeyprivate</td><td>string</td><td>Evet</td><td>Üye işyeri panelinden temin etmiş olduğunuz Private Key.</td></tr><tr><td>apiclientprivate</td><td>string</td><td>Evet</td><td>Üye işyeri panelinden temin etmiş olduğunuz Private Client.</td></tr><tr><td>partnerbased</td><td>bool</td><td>Hayır</td><td>Partnerlik kapsamında kayıt edilen kart için <code>true</code> gönderilmelidir</td></tr><tr><td>partneridentity</td><td>bool</td><td>Evet/Hayır</td><td>Partnerlik kapsamında kayıt edilen kart için Partner hesabının kimlik bilgisi girilmelidir</td></tr><tr><td>cardnumber</td><td>string</td><td>Evet</td><td>Kara listeye eklenmek istenen kartın numarası</td></tr><tr><td>issavedcard</td><td>bool</td><td>Evet</td><td>Kayıtlı kart ile sorgulama yapılacaksa true gönderilmelidir</td></tr><tr><td>uniquecode</td><td>string</td><td>Evet/Hayır</td><td>Saklı kartın kimlik değeri</td></tr></tbody></table>

</details>

**Servisten dönen parametreler şu şekildedir:**

<details>

<summary><strong>Parametre açıklamaları</strong></summary>

<table><thead><tr><th width="184.33333333333331">Parametre</th><th>Type</th><th>Açıklama</th></tr></thead><tbody><tr><td>Name</td><td>string</td><td>Kart ekleme sırasında verilen takma ad</td></tr><tr><td>CardBin</td><td>string</td><td>Kart'a ait BIN bilgisi</td></tr><tr><td>CardLastFour</td><td>string</td><td>Kart'ın son 4 hanesi</td></tr><tr><td>CardNumber</td><td>string</td><td>Maskeli kart numarası. Ekranlarında listeletebilirsiniz</td></tr><tr><td>Expired</td><td>boolean</td><td>Kart'ın son kullanma tarihinin geçtiğini/geçmediğini ifade eder. True gelmesi durumunda o kart ile ödeme alınamaz</td></tr><tr><td>CardTypeId</td><td>int</td><td>Kart'ın markasını ifade eder. MasterCard, Visa vs</td></tr><tr><td>CardType</td><td>string</td><td>Kart'ın markasını string olarak döner</td></tr><tr><td>UniqueCode</td><td>string</td><td>Kart ile ödeme yapılmak istendiğinde kullanılması gereken kart kimliğidir. Bu bilgi belli periyotlarda değişmektedir. Bu nedenle kayıtlı karta ait UniqueCode bilgileri saklanmamalıdır. Her ödeme öncesinde Paywall üzerinden kart listesi alınmalıdır.</td></tr></tbody></table>

</details>

{% tabs %}
{% tab title="✅ Başarılı" %}
{% code lineNumbers="true" %}

```json
{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Id": "25dfec7f-d5b5-4fdc-b4fa-df2b3e58c8aa",
        "InsertDateTimeUtc": "2025-08-06T10:40:30.328134Z",
        "UpdateDateTimeUtc": "0001-01-01T00:00:00",
        "InBlackList": true,
        "IsActive": true
    }
}
```

{% endcode %}
{% endtab %}

{% tab title="❌ Başarısız" %}
{% code lineNumbers="true" %}

```json
{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Id": "00000000-0000-0000-0000-000000000000",
        "InsertDateTimeUtc": "0001-01-01T00:00:00",
        "UpdateDateTimeUtc": "0001-01-01T00:00:00",
        "InBlackList": false,
        "IsActive": false
    }
}
```

{% endcode %}
{% endtab %}
{% endtabs %}