> 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/payment-orchestration-integration-document/wallet-services/3.-transactions/5.-update-description.md).

# 5. Update Description

## **Identify Wallet Record by WalletOwnerId**

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

{% hint style="info" %}
**Note:** Before calling this service, you must include the **apikeypublic** and **apiclientpublic** parameters in the **Header**.

[<mark style="color:green;">**WalletAPI Address**</mark>](/payment-orchestration-integration-document/environment.md)
{% endhint %}

**The parameters to be sent to the service are as follows:**

<table><thead><tr><th width="162">Parameter</th><th width="95.10546875">Type</th><th width="145.078125">Compolsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>The public key used for authentication in API access.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>The public client key that indicates which client the request originates from.</td></tr></tbody></table>

{% tabs %}
{% tab title="Service Request - JSON" %}

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

{% endtab %}
{% endtabs %}

{% tabs %}
{% tab title="Service Request - 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 %}

## Service Response

<table><thead><tr><th width="192">Parameter</th><th width="147.89192708333331">Type</th><th>Description</th></tr></thead><tbody><tr><td>IsFailure</td><td>bool</td><td>A boolean value indicating whether the related service operation has failed</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Indicates whether the service has been completed successfully</td></tr><tr><td>Errors</td><td>Array</td><td>Contains the error messages that may occur during the service execution</td></tr><tr><td>HasNextPage</td><td>bool</td><td>Indicates whether there is a next page in pagination</td></tr><tr><td>HasPreviousPage</td><td>bool</td><td>Indicates whether there is a previous page</td></tr><tr><td>TotalCount</td><td>int</td><td>Represents the total number of records queried</td></tr><tr><td>TotalPages</td><td>int</td><td>Indicates how many pages the results are spread across</td></tr><tr><td>PageNumber</td><td>int</td><td>Indicates the current page number being viewed</td></tr><tr><td>Items</td><td>List</td><td>Contains the list of data objects returned within the page</td></tr></tbody></table>

## Service Response (Items)

<table><thead><tr><th width="234.05859375">Parameter</th><th width="162.38671875">Type</th><th width="348.94140625">Description</th></tr></thead><tbody><tr><td>Id</td><td>Guid</td><td>Represents the unique identifier of the record or transaction in the system</td></tr><tr><td>WalletId</td><td>Guid</td><td>The unique ID of the wallet where the related transaction took place</td></tr><tr><td>TransactionType</td><td>string</td><td>Defines the category of the transaction (e.g., payment, refund, transfer)</td></tr><tr><td>Amount</td><td>decimal</td><td>Represents the total amount used within the transaction</td></tr><tr><td>GiftAmount</td><td>decimal</td><td>The amount used from the bonus balance in the transaction</td></tr><tr><td>Description</td><td>string</td><td>A short descriptive field related to the transaction</td></tr><tr><td>ExternalReference</td><td>string</td><td>A reference code defined in an external system</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Indicates the timestamp when the transaction was created</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>The last updated timestamp of the transaction</td></tr><tr><td>BalanceAfterTransaction</td><td>decimal</td><td>The current remaining wallet balance after the transaction</td></tr><tr><td>SourceWalletId</td><td>Guid</td><td>Indicates the wallet ID from which the funds were deducted</td></tr><tr><td>DestinationWalletId</td><td>Guid</td><td>The wallet ID of the destination where the funds were sent</td></tr><tr><td>GiftBalanceId</td><td>int</td><td>The ID of the bonus balance used in the transaction</td></tr><tr><td>MainTransactionId</td><td>Guid</td><td>The ID of the main (parent) transaction if this transaction is linked</td></tr><tr><td>UniqueCode</td><td>string</td><td>A unique identifier code generated specifically for the transaction</td></tr><tr><td>UsedGiftBalances</td><td>List</td><td>The field where the bonus balances in use are listed</td></tr><tr><td>CashbackAmount</td><td>decimal</td><td>Indicates the cashback amount provided to the user after the transaction</td></tr></tbody></table>