# 7. Dondur

## **Kayıt Üzerinde Dondurma İşlemi Uygulamak için Bilgi Gönder**

<mark style="color:yellow;">`POST`</mark> `{{WalletUrl}}/api/v1/wallet/freeze`&#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 üzerinden yapılan her istekte kullanılan doğrulama anahtarıdır.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>API'yi kullanan istemcinin kimliğini doğrulamak için gönderilen açık anahtardır.</td></tr></tbody></table>

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

```json
{
  "Id": "{{walletId}}",
  "FrozenUntil": null
}
```

{% endtab %}
{% endtabs %}

## Servis İstek

| Parametre   | Tip       | Açıklama                                                                                                                                                                                                                                                |
| ----------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Id          | Guid      | Dondurulacak cüzdan hesabının kimlik bilgisi                                                                                                                                                                                                            |
| FrozenUntil | DateTime? | Boş geçildiğinde, ilgili hesabın dondurulması sizin tarafınızdan kaldırılana kadar hesap kullanılamaz. Eğer spesifik bir tarih verilirse de ilgili hesap verilen tarih/saate bilgisine kadar donuk kalır, sonrasında otomatik kullanılabilir hale gelir |

{% tabs %}
{% tab title="Servis Cevap - 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": "2026-03-24T20:26:25.426Z",
        "IsFrozen": true,
        "IsDeleted": false,
        "CreatedAt": "2025-04-24T09:05:47.980805Z",
        "UpdatedAt": "2025-04-25T12:20:29.7070288Z",
        "TransactionId": null
    },
    "Errors": [],
    "IsSuccess": true,
    "IsFailure": false
}
```

{% 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>Servis çağrısının başarısız olup olmadığını belirten boolean türünde veri alanıdır.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlemin başarılı şekilde tamamlanıp tamamlanmadığını gösteren değerdir.</td></tr><tr><td>Errors</td><td>Array</td><td>Serviste oluşan hata kayıtlarının detaylı olarak listelendiği dizi yapısıdır.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>İstek sonucunda dönen veri nesnelerinin bir arada bulunduğu liste alanıdır.</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 varlıkların benzersiz kimlik numarasını temsil eder.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>Cüzdan sahibine özel atanmış benzersiz kimlik değeridir.</td></tr><tr><td>Name</td><td>string</td><td>Cüzdan sahibinin adı veya kayıtlı şirket ismini ifade eder.</td></tr><tr><td>Alias</td><td>string</td><td>Cüzdana verilen alternatif tanımlayıcı kısa isimdir.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>Cüzdan sahibinin bağlı bulunduğu üye iş yerinin kimliğidir.</td></tr><tr><td>RegionId</td><td>string</td><td>Cüzdan sahibinin kayıtlı olduğu bölgenin temsil kodudur.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>Cüzdan işlemlerinde kullanılan para biriminin ISO kodudur.</td></tr><tr><td>Balance</td><td>decimal</td><td>Cüzdanda mevcut bulunan toplam bakiye miktarıdır.</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>Anlık olarak harcamaya uygun serbest bakiye bilgisidir.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>Cüzdanda yer alan toplam hediye bakiyesi miktarını belirtir.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>Kullanımı kısıtlanmış, bloke altında tutulan bakiye miktarıdır.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>Cüzdanın kullanımına izin verilmeyen tarihe kadar geçerli dondurma süresi bilgisidir.</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Cüzdanın dondurulmuş (geçici olarak kullanılamaz) durumda olup olmadığını gösterir.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>Cüzdan kaydının sistemden silinmiş olup olmadığını belirten kontrol alanıdır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kaydın ilk oluşturulduğu tarih ve zaman damgasıdır.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Kaydın sistem üzerinde en son güncellendiği zaman bilgisidir.</td></tr><tr><td>TransactionId</td><td>Guid</td><td>İşlem kaydının sistemdeki benzersiz kimlik numarasıdır.</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/7.-dondur.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.
