# 2. Kayıtlı Kartlar

## Kayıtlı kart listesi

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

{% 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>](https://developer.paywall.one/ortam)
{% endhint %}

#### Servise gönderilmesi gereken parametreler şu şekildedir :

<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>relationalid1</td><td>string</td><td>Evet</td><td>Kayıtlı karta ait ilişkilendirilmiş birinci değer</td></tr><tr><td>relationalid2</td><td>string</td><td>Hayır</td><td>Kayıtlı karta ait ilişkilendirilmiş ikinci değer</td></tr><tr><td>relationalid3</td><td>string</td><td>Hayır</td><td>Kayıtlı karta ait ilişkilendirilmiş üçüncü değer</td></tr><tr><td>includedetails</td><td>boolean</td><td>Hayır</td><td>Kartın detay bilgileri (Bin, Tip, Marka, Banka vs) dönsün istiyorsanız <code>TRUE</code>olarak göndermelisiniz</td></tr></tbody></table>

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

<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>Identity</td><td>string</td><td>Kart sahibinin kimlik numarası veya vergi kimlik numarası</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>Scope</td><td>int</td><td>Kart'ın hangi alanda kullanılacağını gösteren parametredir</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>

{% tabs %}
{% tab title="JSON" %}
{% code lineNumbers="true" %}

```json
"ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": [
        {
            "Scope": 2,
            "Name": "test kartı",
            "Identity": "",
            "CardBin": "45467121",
            "CardLastFour": "7894",
            "CardHolderName": "Test Kartı",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "Credit",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "30H4WW7Es/HHB7l8PFvl+XnMQs1h0d2/cX7E5H9LgzOw1Ef0E7whSQ==",
            "Details": {
                "CardBankId": 53,
                "CardBank": "T.C.ZİRAAT BANKASI A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 7,
                "CardFamily": "Combo",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Scope": 2,
            "Name": "test kartı",
            "Identity": "273******602",
            "CardBin": "43550930",
            "CardLastFour": "7894",
            "CardHolderName": "Test Kartı",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "Credit",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "EzqrWIPvZAewotdQ48DRsrnu/WBfOwvOctM11rOaeEMvYDqGZzpPxA==",
            "Details": {
                "CardBankId": 58,
                "CardBank": "AKBANK T.A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 4,
                "CardFamily": "Axess",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
```

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