# 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 %}

**Servise gönderilmesi gereken 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>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>

{% tabs %}
{% tab title="Servis İstek - Json" %}

```json
{
  "Id": "{{walletId}}",
  "Amount": 1,
  "Description": "description",
  "ExternalReferenca": "123321-123321-123321-123321"
}
```

{% endtab %}
{% endtabs %}

## Servis İstek

| Parametre         | Tip     | Açıklama                                                       |
| ----------------- | ------- | -------------------------------------------------------------- |
| Id                | Guid    | Para yatırılmak istenen cüzdanın kimlik bilgisi                |
| Amount            | decimal | Yatırılmak istenen tutar                                       |
| Description       | string  | İlgili işlemin açıklaması                                      |
| ExternalReference | string  | İşlemin takip numarası. Bu bilgiyle işlemi takip edebilirsiniz |

{% tabs %}
{% tab title="Servis Cevap - 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
    }
}
```

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

## Servis Cevap

<table><thead><tr><th width="192">Parametre</th><th width="147.89192708333331">Tip</th><th>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></tbody></table>

## Servis Cevap (Value)

<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>Id</td><td>Guid</td><td>Sistemdeki her kayıt için otomatik oluşturulan benzersiz kimlik değeridir.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>Cüzdan sahibine atanan sistem içi benzersiz kimlik numarasıdır.</td></tr><tr><td>Name</td><td>string</td><td>Cüzdan sahibinin ismi veya kuruluş adını temsil eden metinsel ifadedir.</td></tr><tr><td>Alias</td><td>string</td><td>Cüzdana atanmış olan alternatif isim veya kısa tanımlamadır.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>Üye iş yerini gösteren eşsiz kimlik numarasıdır.</td></tr><tr><td>RegionId</td><td>string</td><td>Cüzdan sahibinin kayıtlı olduğu coğrafi bölgeye ait kod bilgisidir.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>İşlemlerde kullanılan para biriminin kısa kodu (örn: TRY, USD) bilgisidir.</td></tr><tr><td>Balance</td><td>decimal</td><td>Cüzdanın toplam sahip olduğu parasal bakiye tutarıdır.</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>Anlık kullanılabilir serbest bakiye değeridir.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>Cüzdanda biriken toplam hediye bakiye miktarını gösterir.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>Kullanımı sınırlandırılmış olan bloke bakiye bilgisidir.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>Cüzdanın askıya alındığı ve tekrar açılacağı tarihi gösterir.</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Cüzdanın donuk (pasif) durumda olup olmadığını belirtir.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>İlgili kaydın sistem üzerinde silinmiş statüde olup olmadığını gösteren alandır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kaydın sistemde ilk oluşturulduğu tarih bilgisidir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Kaydın son düzenleme tarihini ve saat bilgisini içerir.</td></tr><tr><td>TransactionId</td><td>Guid</td><td>İlgili işlem hareketinin benzersiz tanımlayıcı kimlik bilgisidir.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.paywall.one/cuzdan-servisleri/2.-cuzdan/9.-para-yatirma-wallet.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.