# 1. Oluştur (Wallet)

## Cüzdan 'Id' ile Hediye Bakiye Oluştur

<mark style="color:yellow;">`POST`</mark>`{{WalletUrl}}/api/v1/balance/gift`&#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 servislerine genel erişimi sağlayan ortak anahtar bilgisidir.</td></tr><tr><td>apiclientpublic</td><td>string</td><td>Evet</td><td>İstemci uygulamayı tanımlayan açık istemci anahtar bilgisidir.</td></tr></tbody></table>

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

```json
{
    "WalletId": "92858707-7718-435c-9ba3-3d702a3bea9b",
    "Amount": 100.00,
    "ExternalReference": "{{$guid}}",
    "ExpirationDate": "2025-11-11",
    "Description": "External Gift Balance"
}
```

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

## Servis İstek

| Parametre         | Tip       | Açıklama                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| WalletId          | Guid      | Hediye bakiyenin tanımlanacağı cüzdan kimlik bilgisi                                                                                                                                                                                                                                                                                                                                    |
| Amount            | decimal   | Tanımlanacak hediye bakiye                                                                                                                                                                                                                                                                                                                                                              |
| ExpirationDate    | DateTime? | <p>Eğer ilgili hediye bakiye belirli bir tarihe kadar geçerli olsun istiyorsanız. Tarih tanımı yapabilirsiniz.<br><br><mark style="color:purple;">Eğer tarih verirseniz,</mark> ilgili tutar o tarihe kadar harcanmazsa otomatik olarak kullanım dışı kalır.<br><br><mark style="color:orange;">Eğer tarih verilmezse,</mark> ilgili tutar kullanılana kadar cüzdanda tanımlı kalır</p> |
| Description       | string    | <p>Verilen hediye bakiyenin açıklaması<br><br>Örnek: "Doğum günü"</p>                                                                                                                                                                                                                                                                                                                   |
| ExternalReference | string    | İşlemin sisteminiz tarafından takip edilebilmesi için takip numarası                                                                                                                                                                                                                                                                                                                    |

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

```json
{
    "IsSuccess": true,
    "IsFailure": false,
    "Value": {
        "Id": "29bddd16-16d1-4b16-bca9-906f9ef80725",
        "WalletId": "7883fb19-2359-4a9b-b917-f08a259898ed",
        "Amount": 100.00,
        "RemainingAmount": 100.00,
        "ExpirationDate": "2025-11-10T21:00:00Z",
        "IsUnlimited": false,
        "Description": "External Gift Balance",
        "LastTransactionId": null,
        "CreatedAt": "2025-08-20T14:32:16.468416Z",
        "UpdatedAt": null
    }
}
```

{% 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>İşlem başarısızsa false, değilse true döner.</td></tr><tr><td>IsSuccess</td><td>bool</td><td>İşlem başarılıysa true, aksi halde false döner.</td></tr><tr><td>Errors</td><td>Array</td><td>Oluşan hata detaylarını içeren dizi yapısıdır.</td></tr><tr><td>Value</td><td>Array</td><td>Sonuç verilerini içeren öğe listesini barındırı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 bu varlığı benzersiz şekilde tanımlayan kimliktir.</td></tr><tr><td>WalletId</td><td>Guid</td><td>Kaydın bağlı olduğu cüzdanın eşsiz ID bilgisidir.</td></tr><tr><td>Amount</td><td>string</td><td>Tanımlanan toplam tutar bilgisini metinsel olarak tutar.</td></tr><tr><td>RemainingAmount</td><td>decimal</td><td>Mevcut bakiye içerisinden harcanmamış kalan kısmı ifade eder.</td></tr><tr><td>ExpirationDate</td><td>decimal</td><td>Tutarın sona ereceği tarihi timestamp formatında temsil eder.</td></tr><tr><td>IsUnlimited</td><td>string</td><td>Bakiye için geçerlilik süresi sınırsız mı bilgisini tutar ("true"/"false").</td></tr><tr><td>Description</td><td>string</td><td>Tutarın veya işlemin açıklamasıdır, kullanıcıya bilgi verir.</td></tr><tr><td>LastTransactionId</td><td>Guid</td><td>Bu bakiyeyi kullanan son işlemin kimliğidir.</td></tr><tr><td>CreatedAt</td><td>Guid</td><td>Kaydın oluşturulma tarihidir (muhtemelen veri tipi DateTime olmalıdır).</td></tr><tr><td>UpdatedAt</td><td>int</td><td>Kaydın en son ne zaman güncellendiğini gösteren UNIX zaman damgası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/6.-hediye-bakiye/1.-olustur-wallet.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.