> 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/cuzdan-servisleri/2.-cuzdan/9.-para-yatirma-wallet.md).

# 9. Para Yatırma (Wallet)

## **Cüzdan 'Id' Bilgisiyle Para Yatır**

<mark style="color:yellow;">`POST`</mark> `{{WalletUrl}}/api/v1/wallet/deposit`&#x20;

{% hint style="info" %}
Not: Bu servisin kullanılabilmesi için **apikeypublic** ve **apiclientpublic** parametrelerinin Header alanına eklenmiş olması zorunludur.

\
[<mark style="color:green;">**WalletAPI 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="99">Tip</th><th width="102">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Evet</td><td>API isteklerinde erişim izni sağlamak amacıyla kullanılan genel anahtar verisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İstemcinin kimliğini doğrulamak için her istekte gönderilen açık kimlik anahtarıdır.</td></tr></tbody></table>

</details>

<details>

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

<table><thead><tr><th width="162">Parametre</th><th width="99">Tip</th><th width="102">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>Evet</td><td>Para yüklenecek cüzdanın benzersiz tanımlayıcısı </td></tr><tr><td>Amount</td><td>decimal</td><td>Evet</td><td>Yüklenecek tutar. Sıfırdan büyük olmalıdır.</td></tr><tr><td>ExternalReference</td><td>string</td><td>Evet</td><td>Kendi sisteminizdeki işleme ait benzersiz referans numarası. Aynı referansın tekrar gönderilmesi durumunda işlem reddedilebilir</td></tr><tr><td>Description</td><td>string</td><td>Hayır</td><td>İşleme ait açıklama veya not. Opsiyoneldir.</td></tr><tr><td>ExternalTransactionTypeId</td><td>Guid</td><td>Hayır</td><td>Kendi sisteminizdeki işlem tipini UUID olarak belirtir. <code>ExternalTransactionTypeEnum</code> ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.</td></tr><tr><td>ExternalTransactionTypeEnum</td><td>string</td><td>Hayır</td><td>Kendi sisteminizdeki işlem tipini string olarak belirtir. <code>ExternalTransactionTypeId</code> ile birlikte kullanılabilir, ikisi birbirinin alternatifidir.</td></tr></tbody></table>

</details>

<details>

<summary><i class="fa-memo-circle-info">:memo-circle-info:</i>   <mark style="color:blue;"><strong><code>İş Kuralları</code></strong></mark></summary>

{% hint style="info" %}

* `Id` alanında belirtilen cüzdan, ilgili Merchant altında aktif olarak kayıtlı olmalıdır. Bulunamayan bir cüzdan için işlem gerçekleştirilemez.
* `Amount` değeri sıfırdan büyük olmalıdır.
* `ExternalReference` değeri aynı Merchant kapsamında benzersiz olmalıdır. Daha önce kullanılmış bir referans değeri ile yeni işlem oluşturulamaz.
* Silinmiş cüzdanlar üzerinde işlem gerçekleştirilemez.
* Dondurulmuş durumda olan ve dondurma süresi henüz sona ermemiş cüzdanlar için işlem kabul edilmez.
* `ExternalTransactionType` bilgisi gönderildiğinde, belirtilen tipin sistemde tanımlı ve aktif olması gerekmektedir. Geçersiz veya bulunamayan tip bilgisi ile işlem gerçekleştirilemez.
* `ExternalTransactionType` bilgisi ile gerçekleştirilen işlemlerde, ilgili işlem tipine özel tutar ve işlem adedi limitleri kontrol edilir. Limitlerin aşılması durumunda işlem reddedilir.
* `ExternalTransactionType` bilgisi gönderilmediğinde, para yatırma işlemleri için tanımlanan genel tutar ve işlem adedi limitleri uygulanır. Limitlerin aşılması halinde işlem gerçekleştirilemez.
* `ExternalTransactionType` bilgisi gönderilen işlemlerde genel para yatırma limitleri uygulanmaz, yalnızca ilgili işlem tipine özel limitler dikkate alınır.
* Aynı cüzdana 2 saniye içinde tekrar para yatırma isteği gönderilirse işlem reddedilir.
* Para yatırma işlemi tamamlandıktan sonra koşulları sağlayan aktif bir bonus kampanyası bulunması halinde sistem tarafından otomatik olarak bonus işlemi oluşturulur. Kazanılan bonus tutarı `CashbackAmount` alanında iletilir.
* Para yatırma işlemleri için aktif bir komisyon tanımı bulunuyorsa komisyon tutarı işlem tutarı üzerinden hesaplanır, bakiye güncellemesi net tutar üzerinden gerçekleştirilir ve komisyon ayrı bir işlem kaydı olarak oluşturulur.
  {% endhint %}

</details>

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

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

```json
{
  "Id": "{{walletId}}",
  "Amount": 1,
  "Description": "description",
  "ExternalReference": "123321-123321-123321-123321",
  "Description" : "string",
  "ExternalTransactionTypeId" : "123321-123321-123321-123321",
  "ExternalTransactionTypeEnum" : null
}
```

{% endtab %}
{% endtabs %}

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

<details>

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

<table><thead><tr><th width="234.05859375">Parametre</th><th width="162.38671875">Tip</th><th width="348.94140625">Açıklama</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>Gerçekleştirilen işlemin hata ile sonuçlanıp sonuçlanmadığını belirten kontrol bilgisidir.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İlgili servisin başarıyla tamamlandığını ifade eden işaret alanıdır.</td></tr><tr><td>Errors</td><td>Array</td><td>İstek sırasında oluşan hata detaylarının bulunduğu veri listesidir.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>Servisten dönen veri nesnelerinin topluca tutulduğu alanı ifade eder.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Id</td><td>Guid</td><td>Sistemdeki her kayıt için otomatik oluşturulan benzersiz kimlik değeridir.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Alias</td><td>string</td><td>Cüzdana atanmış olan alternatif isim veya kısa tanımlamadır.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > WalletId</td><td>Guid</td><td>İşlemin yapıldığı cüzdanın benzersiz tanımlayıcısı.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > TransactionType</td><td>string</td><td>İşlem tipi.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Amount</td><td>decimal</td><td>Yüklenen tutar.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > GiftAmount</td><td>decimal</td><td>Varsa işleme ait hediye/bonus tutarı.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > Description</td><td>string</td><td>İşleme ait açıklama veya not.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > ExternalReference</td><td>string</td><td>İşleme ait dış sistem referans numarası.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > CreatedAt</td><td>Datetime</td><td>İşlemin oluşturulma tarihi ve saati (UTC)</td></tr><tr><td><mark style="color:yellow;">Value</mark> > UpdatedAt</td><td>Datetime</td><td>İşlemin son güncellenme tarihi ve saati (UTC)</td></tr><tr><td><mark style="color:yellow;">Value</mark> > BalanceAfterTransaction</td><td>decimal</td><td>İşlem sonrası cüzdanın toplam bakiyesi</td></tr><tr><td><mark style="color:yellow;">Value</mark> > GiftBalanceId</td><td>Guid</td><td>Varsa işlemle ilişkili hediye bakiye kaydının tanımlayıcısı.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > UniqueCode</td><td>string</td><td>İşleme ait benzersiz kod.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > CashbackAmount</td><td>decimal</td><td>Varsa işleme ait cashback tutarı.</td></tr><tr><td><mark style="color:yellow;">Value</mark> > AvailableBalanceAfterTransaction</td><td>decimal</td><td>İşlem sonrası cüzdanın kullanılabilir bakiyesi</td></tr></tbody></table>

</details>

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

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "aa230ce5-127d-44a0-b480-7f9c4a24a9fd",
        "Alias": "2816220769",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "TransactionType": "Deposit",
        "Amount": 1,
        "GiftAmount": null,
        "Description": "string",
        "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
        "CreatedAt": "2025-08-20T10:09:37.0074611Z",
        "UpdatedAt": null,
        "BalanceAfterTransaction": 1.00,
        "GiftBalanceId": null,
        "UniqueCode": "68b977f6-58dc-4c48-857a-86fea5ef35c5",
        "CashbackAmount": 0,
        "AvailableBalanceAfterTransaction" : 1.00
    }
}
```

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