# 1. Ekle

## Kara Liste Kart Ekle

<mark style="color:green;">`POST`</mark> `{{Base Adres}}/paywall/blacklist/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 (HEADERS) parametreler şu şekildedir :

<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>

#### Servise gönderilmesi gereken (BODY) parametreler şu şekildedir :

<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>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 sürecin ilerletilmesi durumunda <code>true</code> olarak gönderilmelidir</td></tr><tr><td>UniqueCode</td><td>string</td><td>Evet/Hayır</td><td>Kayıtlı karta ait kimlik bilgisidir</td></tr></tbody></table>

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

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

```json5
{
    "PartnerBased": false,
    "PartnerIdentity": "e00fee4d-304f-4038-bf25-d31ee53856a9",
    "RelationalId1": "test1111",
    "RelationalId2": null,
    "RelationalId3": null,
    "IsSavedCard": true,
    "UniqueCode": "mfUpwRXYvgxCy2n4aGWT+ygqQ==",
    "CardNumber": ""
}
```

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

Servisten dönen parametreler şu şekildedir:

<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></tbody></table>

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

```json
{
    "ErrorCode": 0,
    "Result": true,
    "Message": "",
    "Body": {
        "Id": "b49f1ed8-eef7-4215-8bbb-55451fdc03ff"
    }
}
```

{% endcode %}
{% endtab %}

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

```json
{
    "ErrorCode": 4,
    "Result": false,
    "Message": "Card already in Blacklist",
    "Body": null
}
```

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