# 5. Update

## **Update Wallet**

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

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

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

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

<table><thead><tr><th width="162">Parameter</th><th width="97.671875">Type</th><th width="141.52734375">Compulsory</th><th width="403">Description</th></tr></thead><tbody><tr><td>apikeypublic</td><td>string</td><td>Yes</td><td>It is the public key used for authentication during API access.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Yes</td><td>It is the key value used to specify the identity of the API client.</td></tr></tbody></table>

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

```json
{
  "Id": "0000-0000-0000-0000-0000",
  "Name": "cüzdanın güncellenen ismi",
  "AllowOverdraft": false,
  "OverdraftLimit": 0
}
```

{% endtab %}
{% endtabs %}

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

```json
{
    "Value": {
        "Id": "30bac1c0-ad6b-4c50-a52e-1b34f9b487a7",
        "WalletOwnerId": "b5708099-be62-4d34-af06-27132082eb78",
        "Name": "juzdan1",
        "Alias": "8203287943",
        "MerchantId": 2071,
        "RegionId": 1,
        "CurrencyCode": "TRY",
        "Balance": 1.00,
        "AvailableBalance": 1.00,
        "TotalGiftBalance": 0,
        "BlockedBalance": 0,
        "FrozenUntil": "0001-01-01T00:00:00",
        "IsFrozen": false,
        "IsDeleted": false,
        "CreatedAt": "2025-04-24T09:05:47.980805Z",
        "UpdatedAt": "2025-04-25T10:01:20.870433Z",
        "TransactionId": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}
```

{% 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>It is the control field that determines whether the operation has resulted in failure or not.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>It is the flag value that indicates whether the API call was successfully completed.</td></tr><tr><td>Errors</td><td>Array</td><td>It is the list structure containing the error details that occurred during the service operation.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>It is the list of data returned after successful calls.</td></tr></tbody></table>

## **Service Response (Value)**

<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>It is the unique identifier number of the object registered in the system.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>It is the unique identity of the relevant wallet owner.</td></tr><tr><td>Name</td><td>string</td><td>It is the field representing the wallet owner's name or company name.</td></tr><tr><td>Alias</td><td>string</td><td>It is the alternate name or short name assigned to the wallet.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>It is the merchant ID associated with the wallet owner.</td></tr><tr><td>RegionId</td><td>string</td><td>It is the code representing the region where the wallet is registered.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>It is the international code of the currency used in the wallet.</td></tr><tr><td>Balance</td><td>decimal</td><td>Shows the total balance amount on the wallet</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>Indicates the currently available balance amount for transactions.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>Represents the total amount of gift balance.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>Represents the blocked balance that cannot be used.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>It is the valid date until the wallet's frozen period ends.</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Indicates whether the wallet is in a frozen (freeze) state.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>Indicates whether the wallet record has been deleted from the system.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>It is the timestamp when the record was created in the system.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>It is the date and time when the record was last updated.</td></tr><tr><td>TransactionId</td><td>Guid</td><td>It is the unique identifier of the transaction record in the system.</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/payment-orchestration-integration-document/wallet-services/2.-wallet/5.-update.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.