# 3. Kayıtlı Kartlar

## Kayıtlı kart listesi

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

{% 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>bool</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><tr><td>partneridentity</td><td>bool</td><td>Hayır</td><td>Partnerlik kapsamında kayıt edilen kart için Partner hesabının kimlik bilgisi girilmelidir</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>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><tr><td>InsertDateTimeUtc</td><td>DateTime</td><td>Kartın eklenme süresine ait tarih bilgisidir. UTC olarak dönmektedir</td></tr></tbody></table>

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

```json
{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": [
        {
            "Name": "Test Card",
            "CardBin": "453144",
            "CardLastFour": "2283",
            "CardHolderName": "Emir Selim Tütüncü",
            "CardNumber": "453144******2283",
            "Expired": false,
            "CardTypeId": 0,
            "CardType": "Visa",
            "Month": 12,
            "Year": 2025,
            "UniqueCode": "VtsSMsRKBLJMZBApXZrlyTLmKwu6SGYiSFl7/Q2n1d0j5Pon9uA6GQ==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 77,
                "CardBank": "AKTİF YATIRIM BANKASI A.Ş.",
                "CardBrandId": 2,
                "CardBrand": "Visa",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 1,
                "CardKind": "Bireysel Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Name": "EnesIsbank",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "Enes Selman Tütüncü",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 9,
            "Year": 2027,
            "UniqueCode": "GG76g2CXnNky6rJEH5UOYYHZZzfONZhWS83O5/Ah5TUmmZ74oF0Ahw==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
        {
            "Name": "thryhrt",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "thryhrt",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 12,
            "Year": 2030,
            "UniqueCode": "bzkBzQ5bH9KOtZ+wgI4RiVxBH2WYF9QeYC94wCqwAn51vC7wrYR4wA==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        },
        {
            "Name": "thryhrt",
            "CardBin": "552879",
            "CardLastFour": "0008",
            "CardHolderName": "thryhrt",
            "CardNumber": "552879******0008",
            "Expired": false,
            "CardTypeId": 1,
            "CardType": "MasterCard",
            "Month": 12,
            "Year": 2030,
            "UniqueCode": "IiPYc67bYVYrChRnB4ThSVMERFSw5Vt2PUaBcXeKw9HBTwWqXOSbdQ==",
            "InsertDateTimeUtc": "2026-02-19T22:37:44.397415Z",
            "Details": {
                "CardBankId": 55,
                "CardBank": "T.HALK BANKASI A.Ş.",
                "CardBrandId": 1,
                "CardBrand": "Master Card",
                "CardFamilyId": 5,
                "CardFamily": "Paraf",
                "CardKindId": 2,
                "CardKind": "Ticari Kart",
                "CardTypeId": 1,
                "CardType": "Credit"
            }
        }
    ]
}
```

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