> 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/kart-kaydetme/1.-yeni-kart.md).

# 1. Yeni Kart

## Yeni Kart Sakla

<mark style="color:green;">`POST`</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>](/ortam.md)
{% endhint %}

**Gerekli header ve istek parametreleri :**

<details>

<summary><strong>Zorunlu header parametreleri</strong></summary>

<table><thead><tr><th width="162">Parametre</th><th width="79">Tip</th><th width="107">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></tbody></table>

</details>

<details>

<summary><strong>İstek gövdesi parametreleri</strong></summary>

<table><thead><tr><th width="244">Parametre</th><th width="92">Tip</th><th width="127">Zorunlu</th><th width="336">Açıklama</th></tr></thead><tbody><tr><td>PartnerBased</td><td>bool</td><td>Hayır</td><td>Eğer kartlar Partner'lik yönetimi kapsamında ortak bir havuzda kayıt edilecekse kullanılmalıdır</td></tr><tr><td>PartnerIdentity</td><td>string</td><td>Evet/Hayır</td><td>Partnerlik kapsamında kayıt edilecek ise Partner hesabınızın kimlik bilgisi</td></tr><tr><td>RelationalId1</td><td>string</td><td>Evet</td><td>Kart'ın ilişkilendirilmesi istenen unique bilgi</td></tr><tr><td>RelationalId2</td><td>string</td><td>Hayır</td><td>Kart'ın ilişkilendirilmesi istenen unique ikinci bilgi (listeleme anında tüm bilgiler gönderilmelidir)</td></tr><tr><td>RelationalId3</td><td>string</td><td>Hayır</td><td>Kart'ın ilişkilendirilmesi istenen unique üçüncü bilgi (listeleme anında tüm bilgiler gönderilmelidir)</td></tr><tr><td>Nickname</td><td>string</td><td>Evet</td><td>Kart'ın takma ismi (Örnek: Yüksek limitli kartım)</td></tr><tr><td>HolderName</td><td>string</td><td>Evet</td><td>Kart'ın üstündeki kart sahibi adı</td></tr><tr><td>Number</td><td>string</td><td>Evet</td><td>Kart'ın numarası</td></tr><tr><td>Month</td><td>int</td><td>Evet</td><td>Kart'ın son kullanılma tarihi (ay)</td></tr><tr><td>Year</td><td>int</td><td>Evet</td><td>Kart'ın son kullanılma tarihi (yıl) - Parametre 4 karakter olmalıdır</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><tr><td>PreventDuplicate</td><td>bool </td><td>Hayır</td><td>Aynı kartın tekrar kayıt edilmesini engeller.  </td></tr><tr><td>PreventDuplicateHours</td><td>int</td><td>Hayır</td><td>Aynı kullanıcının belirli bir merchant'a belirli saat aralığında yeni kart kaydını engeller.</td></tr></tbody></table>

</details>

**Servise gönderilecek örnek bir JSON dosyası şu şekildedir :**

{% tabs %}
{% tab title="JSON" %}

<pre class="language-json5" data-line-numbers><code class="lang-json5"><strong>{
</strong>    "PartnerBased": false,
    "PartnerIdentity": "",
    "RelationalId1": "1000923",
    "RelationalId2": "",
    "RelationalId3": "",
    "Card": {
        "Nickname": "İş bankası kartım",
        "HolderName": "Emir Selim Tütüncü",
        "Number": "4546711234567894",
        "Month": 12,
        "Year": 2026
    },
    "IncludeDetails": true,
    "PreventDuplicate": false, 
    "PreventDuplicateHours": 1
}
</code></pre>

{% endtab %}
{% endtabs %}

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

<details>

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

<table><thead><tr><th width="189">Parametre</th><th width="100.33333333333331">Tip</th><th>Açıklama</th></tr></thead><tbody><tr><td>ErrorCode</td><td>int</td><td>Hata kodu. İşlem başarılı ise '0' değerini döner.</td></tr><tr><td>Result</td><td>bool</td><td>True ya da false değeri döner. İşlem başarılı iste 'true' değerini döner.</td></tr><tr><td>Message</td><td>string</td><td>İşlem hatalıysa, bu hataya dair belirtilen mesajdır, locale parametresine göre dil desteği sunar.</td></tr><tr><td>Body</td><td>nesne</td><td>İşlem hatalıysa, bu hataya dair detay nesne</td></tr><tr><td>Name</td><td>string</td><td>Kullanıcının karta verdiği özel isim.</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>CardHolderName</td><td>string</td><td>Kart sahibinin maskeli adı.</td></tr><tr><td>CardNumber</td><td>string</td><td>Maskeli kart numarası. Ekranlarında listeletebilirsiniz.</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>Month</td><td>int</td><td>Kartın son kullanma ayı.</td></tr><tr><td>Year</td><td>int</td><td>Kartın son kullanma yılı.</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>Details.CardBankId</td><td>int</td><td>Kartın ait olduğu bankanın ID değeri.</td></tr><tr><td>Details.CardBank</td><td>string</td><td>Kartın ait olduğu bankanın adı.</td></tr><tr><td>Details.CardBrandId</td><td>int</td><td>Kart markasının ID değeri.</td></tr><tr><td>Details.CardBrand</td><td>string</td><td>Kart markasının adı.</td></tr><tr><td>Details.CardFamilyId</td><td>int</td><td>Kart ailesinin ID değeri.</td></tr><tr><td>Details.CardFamily</td><td>string</td><td>Kart ailesinin adı.</td></tr><tr><td>Details.CardKindId</td><td>int</td><td>Kartın bireysel/kurumsal ayrımının ID değeri.</td></tr><tr><td>Details.CardKind</td><td>string</td><td>Kartın bireysel/kurumsal ayrımı.</td></tr><tr><td>Details.CardTypeId</td><td>int</td><td>Kartın debit/credit/prepaid ayrımının ID değeri.</td></tr><tr><td>Details.CardType</td><td>string</td><td>Kartın debit/credit/prepaid ayrımı.</td></tr></tbody></table>

</details>

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

```json
{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Name": "İş bankası kartım",
        "CardBin": "444676",
        "CardLastFour": "3623",
        "CardHolderName": "E*i* S*l*m T*t*n*ü",
        "CardNumber": "454671******7894",
        "CardTypeId": 0,
        "CardType": "Visa",
        "Month": 12,
        "Year": 2026,
        "UniqueCode": "hNNqz1Yy2sb59BSKdF1S0pgrwBWvUuNxG8WiVq4T1AgK56FQljAlKQ==",
        "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"
        }
    }
}
```

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