# 4. Oluştur

## **Cüzdan Oluştur**

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

{% hint style="info" %}
Not: Servis çağrısından önce **apikeypublic** ve **apiclientpublic** bilgilerinin Header alanına eklenmiş olması şarttır.

[<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 isteklerinde kimlik doğrulaması için kullanılan genel erişim anahtarıdır.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>API'yi çağıran istemcinin kimliğini belirten açık anahtar değeridir.</td></tr></tbody></table>

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

```json
{
  "WalletOwnerId": "9edb23f2-7362-42a8-8eb4-0c89ffb397b0",
  "Name": "{{$randomFirstName}}",
  "RegionId": 1,
  "CurrencyCode": "try", // usd, eur, all
  "Alias": "1234567890", // 10 digit number
  "Description": "Cüzdanım",
  "AllowOverdraft": false,
  "OverdraftLimit": 0
}
```

{% endtab %}
{% endtabs %}

## Servis İstek

| Parametre     | Tip    | Açıklama                                                                                                  |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------- |
| WalletOwnerId | Guid   | Cüzdan sahibinin kimlik bilgisi                                                                           |
| Name          | string | Cüzdan hesabına verilecek olan isim                                                                       |
| RegionId      | int    | <p>Cüzdan'a ait ülkenin kimlik bilgisi<br><br>Bkz: <a href="/pages/KiW740WHj5K5RTpukhMh">Bölgeler</a></p> |
| CurrencyCode  | string | <p>Para birimi<br><br>Bkz: <a href="/pages/bahfUMz1dqpN1ZCnpVtM">Para birimi</a></p>                      |
| Alias         | string | Tekil cüzdan numarası                                                                                     |
| Description   | string | Cüzdan hesabına verilecek açıklama                                                                        |

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

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "e75df134-185a-4b2b-b501-719dba2129c4",
        "WalletOwnerId": "0a949877-0ea0-48c3-9c92-41c9e33c461d",
        "Name": "External Test Wallet",
        "Alias": "5746347646",
        "RegionId": 1,
        "CurrencyCode": "TRY",
        "Balance": 0,
        "AvailableBalance": 0,
        "TotalGiftBalance": 0,
        "BlockedBalance": 0,
        "CreatedAt": "2025-08-20T10:04:01.3659489Z",
        "AllowOverdraft": false,
        "OverdraftLimit": 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>Yapılan API çağrısının başarısız sonuçlanıp sonuçlanmadığını gösteren alan.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>Servis çağrısının başarılı şekilde tamamlanıp tamamlanmadığını belirten değerdir.</td></tr><tr><td>Errors</td><td>Array</td><td>İstek sırasında oluşan hata bilgilerini listeleyen veri yapısıdır.</td></tr><tr><td>Value</td><td>Array&#x3C;Items></td><td>Servisten dönen asıl veri nesnesini temsil eden liste yapısı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>Sistemde kaydedilen varlığın benzersiz kimlik numarasıdır.</td></tr><tr><td>WalletOwnerId</td><td>Guid</td><td>Cüzdan sahibine ait eşsiz kimlik bilgisidir.</td></tr><tr><td>Name</td><td>string</td><td>Cüzdan sahibinin adı veya ticari unvanı bilgisidir.</td></tr><tr><td>Alias</td><td>string</td><td>Cüzdan için atanmış alternatif ad veya kısa isimdir.</td></tr><tr><td>MerchantId</td><td>Guid</td><td>Cüzdanın ilişkili olduğu üye iş yerinin kimlik numarasıdır.</td></tr><tr><td>RegionId</td><td>string</td><td>Cüzdan sahibinin kayıtlı olduğu coğrafi bölgeyi temsil eden koddur.</td></tr><tr><td>CurrencyCode</td><td>string</td><td>Kullanılan para biriminin uluslararası kod bilgisidir (örneğin: TRY, USD).</td></tr><tr><td>Balance</td><td>decimal</td><td>Cüzdanın toplam mevcut bakiyesi bilgisidir.</td></tr><tr><td>AvailableBalance</td><td>decimal</td><td>Kullanılabilir durumdaki bakiye miktarını ifade eder.</td></tr><tr><td>TotalGiftBalance</td><td>decimal</td><td>Cüzdanda bulunan toplam hediye bakiyesi miktarıdır.</td></tr><tr><td>BlockedBalance</td><td>decimal</td><td>Kullanılamayan bloke edilmiş bakiye miktarıdır.</td></tr><tr><td>FrozenUntil</td><td>DateTime</td><td>Cüzdanın dondurulmuş olduğu süre sonuna kadar geçerli olan tarih bilgisidir.</td></tr><tr><td>IsFrozen</td><td>bool</td><td>Cüzdanın şu anda dondurulmuş olup olmadığını gösteren durum bilgisidir.</td></tr><tr><td>IsDeleted</td><td>bool</td><td>Cüzdanın sistemde silinmiş durumda olup olmadığını belirten alandır.</td></tr><tr><td>CreatedAt</td><td>DateTime</td><td>Kaydın sistemde oluşturulduğu tarih ve saat bilgisidir.</td></tr><tr><td>UpdatedAt</td><td>DateTime</td><td>Kaydın sistemde en son güncellendiği zaman bilgisidir.</td></tr><tr><td>TransactionId</td><td>Guid</td><td>Cüzdan hesabından yapılan son işleme ait kimlik bilgisi</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/4.-olustur.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.