> 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/3.-islemler/5.-aciklama-guncelle.md).

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

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

</details>

<details>

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

<table><thead><tr><th width="137">Parametre</th><th width="103">Tip</th><th width="105">Zorunlu</th><th width="403">Açıklama</th></tr></thead><tbody><tr><td>TransactionId</td><td>guid</td><td>Evet</td><td>Açıklaması güncellenecek işlemin benzersiz tanımlayıcısı</td></tr><tr><td>Description</td><td>string</td><td>Evet</td><td>İşlem için yeni açıklama metni</td></tr></tbody></table>

</details>

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

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

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

{% 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>İ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>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>Alias</td><td>String</td><td>İşlemin yapıldığı cüzdanın alias'ı</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>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>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></tbody></table>

</details>

{% tabs %}
{% tab title="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": 100.00,
        "Description": "Bakiye yükleme işlemi",
        "ExternalReference": "4dcac110-5511-4cdf-9047-c27bfdb203fb",
        "CreatedAt": "2025-08-20T11:56:17.206107Z",
        "UpdatedAt": "2025-08-20T12:10:00.000000Z",
        "BalanceAfterTransaction": 200.00,
        "MainTransactionId": null,
        "UniqueCode": "bdf7ab45-2437-4f3b-ab56-5402f1c69654"
    }
}
```

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