# 5. Açıklama Güncelle

## **Cüzdan Kaydını** WalletOwnerId ile Tanımla 

<mark style="color:orange;">`PUT`</mark> `{{WalletUrl}}/api/v1/wallet/transaction/description`

{% hint style="info" %}
**Not**: Bu servisi çağırmadan önce, **apikeypublic** ve **apiclientpublic** parametrelerini **Header** kısmına eklemeniz gereklidir.

[<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 erişiminde doğrulama için kullanılan genel anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İsteğin hangi istemciden geldiğini gösteren genel istemci anahtarıdır.</td></tr></tbody></table>

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

```json
{
  "TransactionId": "95d2b18a-8a91-46e4-8d21-80d76135e4ef",
  "Description": "Updated external transaction description"
}
```

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Servis Cevap - Json" %}
{% code lineNumbers="true" %}

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": [
        {
            "Id": "e1e2f263-7c0c-4997-a6c9-3e70de4ebda5",
            "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
            "Alias": "2816220769",
            "TransactionType": "Deposit",
            "Amount": 100000.00,
            "GiftAmount": null,
            "Description": "string",
            "ExternalReference": "5bc276c8-acb5-4cb7-90fe-1d3ff10fbcfb",
            "CreatedAt": "2025-08-20T11:56:17.206107Z",
            "UpdatedAt": null,
            "BalanceAfterTransaction": 100000.80,
            "BlockedBalanceAfterTransaction": 0.00,
            "AvailableBalanceAfterTransaction": 100000.80,
            "GiftBalanceBalanceAfterTransaction": 0.00,
            "CurrencyCode": "TRY",
            "SourceWalletId": null,
            "DestinationWalletId": null,
            "GiftBalanceId": null,
            "MainTransactionId": null,
            "UniqueCode": "bdf7ab45-2437-4f3b-ab56-5402f1c69654",
            "UsedGiftBalances": null,
            "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>İlgili servis işleminin başarısız olup olmadığını belirten boolen değerdir.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İlgili servisin başarılı şekilde tamamlanıp tamamlanmadığını ifade eder.</td></tr><tr><td>Errors</td><td>Array</td><td>Servis sırasında oluşabilecek hata mesajlarının bulunduğu bilgi alanıdır.</td></tr><tr><td>HasNextPage</td><td>bool</td><td>Listeleme işlemlerinde bir sonraki sayfanın olup olmadığını belirtir.</td></tr><tr><td>HasPreviousPage</td><td>bool</td><td>Önceki bir sayfanın varlığını gösteren işaret bilgisidir.</td></tr><tr><td>TotalCount</td><td>int</td><td>Sorgulanan toplam kayıt adedini ifade eder.</td></tr><tr><td>TotalPages</td><td>int</td><td>Sonuçların kaç sayfada toplandığını gösterir.</td></tr><tr><td>PageNumber</td><td>int</td><td>Mevcut görüntülenen sayfanın numarasını belirtir.</td></tr><tr><td>Items</td><td>List</td><td>Sayfa içerisinde dönen veri nesnelerinin listesini içerir.</td></tr></tbody></table>

## Servis Cevap (Items)

<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>Kayıt veya işlemin sistemdeki eşsiz kimliğini temsil eder.</td></tr><tr><td>WalletId</td><td>Guid</td><td>İlgili işlemin gerçekleştiği cüzdanın benzersiz ID numarasıdır.</td></tr><tr><td>TransactionType</td><td>string</td><td>İşlemin kategorisini tanımlar (örneğin: ödeme, iade, transfer).</td></tr><tr><td>Amount</td><td>decimal</td><td>İşlem kapsamında kullanılan toplam tutarı ifade eder.</td></tr><tr><td>GiftAmount</td><td>decimal</td><td>İşlemde hediye bakiyesinden kullanılan miktardır.</td></tr><tr><td>Description</td><td>string</td><td>İşlemle ilgili açıklayıcı kısa bilgi alanıdır.</td></tr><tr><td>ExternalReference</td><td>string</td><td>Harici bir sistemde tanımlanan referans kodudur.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>İşlemin oluşturulma zaman damgasını belirtir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>İşlemin güncellenmiş olduğu son zaman bilgisidir.</td></tr><tr><td>BalanceAfterTransaction</td><td>decimal</td><td>İşlem sonrası cüzdanda kalan güncel bakiye miktarıdır.</td></tr><tr><td>SourceWalletId</td><td>Guid</td><td>Paranın çıkış yaptığı cüzdanın kimliğini gösterir.</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>Paranın gönderildiği hedef cüzdanın kimlik bilgisidir.</td></tr><tr><td>GiftBalanceId</td><td>int</td><td>İşlemde kullanılan hediye bakiyesine ait kimlik numarasıdır.</td></tr><tr><td>MainTransactionId</td><td>Guid</td><td>Bağlantılı asıl işlemin sistemdeki ID bilgisidir.</td></tr><tr><td>UniqueCode</td><td>string</td><td>İşleme özel üretilmiş eşsiz tanımlayıcı koddur.</td></tr><tr><td>UsedGiftBalances</td><td>List</td><td>Kullanımda olan hediye bakiye bilgilerinin listelendiği alandır.</td></tr><tr><td>CashbackAmount</td><td>decimal</td><td>İşlem sonrasında kullanıcıya sağlanan cashback tutarını gösterir.</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/3.-islemler/5.-aciklama-guncelle.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.